lacrm-mcp

An MCP (Model Context Protocol) server that lets AI assistants such as Claude work with a Less Annoying CRM account: search contacts, read notes and tasks, look at pipelines, and (optionally) add notes, tasks and contacts or move pipeline items.

Independent, unofficial project. lacrm-mcp is built by Northkeel Labs against LACRM's public API v2 documentation. It is not affiliated with, endorsed by, or supported by Less Annoying CRM. "Less Annoying CRM" and "LACRM" are names of their respective owner and are used only to describe compatibility.

60-second quickstart

1. In LACRM go to Settings > Programmer API and create an API key. Give it only the permissions you need (read-only is enough for the six read tools).

2. Install uv and clone this repo (or pip install .).

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "lacrm": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/lacrm-mcp", "lacrm-mcp", "--read-only"],
      "env": { "LACRM_API_KEY": "your-api-key" }
    }
  }
}

Claude Code:

claude mcp add lacrm --env LACRM_API_KEY=your-api-key -- \
  uv run --directory /path/to/lacrm-mcp lacrm-mcp --read-only

Drop --read-only when you want the write tools. Then ask, for example: "Find contacts at Acme and show their latest notes" or "What tasks are due this week?"

Related MCP server: BackCrew HubSpot MCP Server

Tools

There are no delete tools. List tools return at most 50 results per page and report has_more_results; long text fields are truncated at 2,000 characters.

Read-only mode

Set LACRM_READ_ONLY=1 or pass --read-only. The four write tools are then not registered at all (the model never sees them), and a second check refuses writes if one is somehow called. Combine this with a read-only API key for defence in depth.

Configuration

How it talks to LACRM

POST to https://api.lessannoyingcrm.com/v2/ with an Authorization: <key> header and a JSON body {"Function": "...", "Parameters": {...}}, per the API v2 documentation. HTTP 400 responses carry ErrorCode and an error description, which are surfaced (with secrets redacted). The docs do not describe rate limits, so on HTTP 429 the client retries with exponential backoff (honouring Retry-After if sent, capped at 30 s) and reports the wait in the final error. Writes are never retried on 5xx or timeout, to avoid duplicate records.

Security notes

See SECURITY.md. In short: CRM text is untrusted input to the model, so results are size-bounded and labelled as data; write access is opt-in and narrow; the key never leaves the environment or appears in logs or errors. Review what an assistant proposes before approving write actions in your client.

Development

uv sync --extra dev      # or: python -m venv .venv && pip install -e '.[dev]'
uv run pytest            # all HTTP is mocked; no network or API key needed

Requires Python 3.11+ and the MCP Python SDK 1.x (mcp<2, which provides FastMCP).

Licence

MIT. See LICENSE.