# Less Annoying CRM

This MCP server for Claude Code connects an assistant to Less Annoying CRM. It searches contacts and reads notes, tasks, and pipeline data, with optional tools for making changes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: northkeellabs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/northkeellabs/lacrm-mcp
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/less-annoying-crm

## What it does

The server gives an assistant API access to Less Annoying CRM. It can search for contacts, retrieve contact details and notes, list tasks, and inspect pipelines and their items. There are 10 tools: six for reading and four for writing.

Pass `--read-only` or set `LACRM_READ_ONLY=1` to disable the write tools; they are then not registered. The server has no delete tools. Lists return up to 50 results per page, and long text fields are cut off at 2,000 characters.

Running it requires a Less Annoying CRM API key in `LACRM_API_KEY` and `uvx`. The key is read from the environment, and CRM requests need it to run.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `LACRM_API_KEY`, `LACRM_READ_ONLY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env LACRM_API_KEY=<LACRM_API_KEY> --env LACRM_READ_ONLY=<LACRM_READ_ONLY> --transport stdio less-annoying-crm -- uvx lacrm-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from lacrm-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add less-annoying-crm --env LACRM_API_KEY=<LACRM_API_KEY> --env LACRM_READ_ONLY=<LACRM_READ_ONLY> -- uvx lacrm-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from lacrm-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "less-annoying-crm": {
            "command": "uvx",
            "args": [
                "lacrm-mcp"
            ],
            "env": {
                "LACRM_API_KEY": "<LACRM_API_KEY>",
                "LACRM_READ_ONLY": "<LACRM_READ_ONLY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from lacrm-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "less-annoying-crm": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "lacrm-mcp"
            ],
            "env": {
                "LACRM_API_KEY": "<LACRM_API_KEY>",
                "LACRM_READ_ONLY": "<LACRM_READ_ONLY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from lacrm-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e LACRM_API_KEY=<LACRM_API_KEY> -e LACRM_READ_ONLY=<LACRM_READ_ONLY> less-annoying-crm uvx lacrm-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from lacrm-mcp <command>

## When to use it
- find a contact in Less Annoying CRM
- read a contact’s notes and tasks
- inspect items in a sales pipeline
- create a contact, task, or note
- change a pipeline item’s status

## Example prompts
- Find a contact by name in Less Annoying CRM and show their notes.
- List my Less Annoying CRM tasks.
- Add a note to this contact and change the pipeline item’s status.

## Similar
- [Less Annoying CRM (remote, OAuth)](https://affpapa.org/en/nevibecode/mcp/less-annoying-crm-remote-oauth.md) — MCP server
- [Perfex CRM](https://affpapa.org/en/nevibecode/mcp/perfex-crm.md) — MCP server · ★ 5 repo stars
- [FavCRM — Agentic CRM](https://affpapa.org/en/nevibecode/mcp/favcrm-agentic-crm.md) — MCP server · 8514 installs
- [crm-data-governance](https://affpapa.org/en/nevibecode/skills/crm-data-governance.md) — skill · 27400 installs
- [zoho-crm](https://affpapa.org/en/nevibecode/skills/zoho-crm.md) — skill · 575 installs
- [Kylas CRM](https://affpapa.org/en/nevibecode/mcp/kylas-crm.md) — MCP server · ★ 12 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
