namakan-mcp-crm

One MCP server for every CRM. Agents call crm_find_contact / crm_list_deals — they never learn whether the plant runs HubSpot, Salesforce, Dynamics, Pipedrive, or Zoho.

Ships with a mock CRM so it works before anyone hands you an API key. Writes are off until you set an env var.

Run in 60 seconds

pip install git+https://github.com/cfollette18/namakan-mcp-crm.git
namakan-mcp-crm demo
namakan-mcp-crm tools
namakan-mcp-crm call crm_find_contact query=alex

demo prints three JSON blobs: a contact lookup, a deal list, and a failed write (read-only default). That last one is intentional.

Related MCP server: Company Records

How it fits

flowchart LR
  Agent[Hermes / Cursor / Claude Desktop] -->|MCP stdio| Server[namakan-mcp-crm]
  Server --> Tools[crm_find_contact etc.]
  Tools --> Mock[mock backend]
  Tools --> Rest[generic REST]
  Tools --> Vendor[HubSpot / Salesforce / ... adapter]

Swap the backend with NAMAKAN_CRM_BACKEND. The tool names do not change.

Wire it into Cursor

Create or edit .cursor/mcp.json (project) or ~/.cursor/mcp.json:

{
  "mcpServers": {
    "namakan-crm": {
      "command": "namakan-mcp-crm",
      "args": ["serve"],
      "env": {
        "NAMAKAN_CRM_BACKEND": "mock"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json) and Hermes MCP config use the same command / env shape. Hosts that pass no args also work: namakan-mcp-crm with no subcommand is serve.

CLI

Tools

Backends

Writes

NAMAKAN_MCP_ALLOW_WRITES=1 NAMAKAN_MCP_DRY_RUN=1 namakan-mcp-crm call crm_create_deal name=Test

Dry-run returns { "dry_run": true, "would_call": ... } and does not touch the store. Production writes need that env and a human approval path (Namakan: ciso).

Python

from namakan_mcp_crm import handle
from namakan_mcp_crm.backends import MockCrm

print(handle("crm_find_contact", {"query": "alex"}, backend=MockCrm()))

License

MIT. Copyright (c) 2026 Namakan AI Engineering.