amoCRM MCP Server

MCP server for amoCRM (Kommo) API v4. Exposes 36 tools for leads, contacts, companies, tasks, notes, pipelines, associations, analytics, and more.

Built with FastMCP. Works with Claude Desktop, Cursor, and any MCP-compatible client.

Features

• 36 MCP tools across 11 domains (leads, contacts, companies, tasks, notes, pipelines, associations, account, batch, unsorted, analytics)
• OAuth 2.0 token refresh with disk persistence
• Rate limiting — 7 req/s with automatic 429 backoff and jitter
• HAL+JSON normalization — strips _links, flattens _embedded
• Consistent response envelopes — {data, pagination} or {error, status_code, detail}
• stdio and SSE transports

Quick Start

1. Install

pip install -e .

2. Configure

Copy .env.example to .env and fill in your amoCRM credentials:

cp .env.example .env

You need at minimum:

• AMO_SUBDOMAIN — your amoCRM account subdomain
• AMO_ACCESS_TOKEN — OAuth access token

For automatic token refresh, also set:

• AMO_CLIENT_ID, AMO_CLIENT_SECRET, AMO_REFRESH_TOKEN

3. Run

# stdio (default — for Claude Desktop, Cursor, etc.)
python -m amocrm_mcp

# SSE transport
AMO_TRANSPORT=sse AMO_PORT=8000 python -m amocrm_mcp

Claude Desktop config

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "amocrm": {
      "command": "python",
      "args": ["-m", "amocrm_mcp"],
      "env": {
        "AMO_SUBDOMAIN": "your-subdomain",
        "AMO_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

Tools

Domain	Tools	Description
Leads	leads_list, leads_get, leads_search, leads_create, leads_create_complex, leads_update	Full lead lifecycle
Contacts	contacts_get, contacts_search, contacts_create, contacts_update	Contact management
Companies	companies_get, companies_search, companies_create, companies_update	Company management
Tasks	tasks_list, tasks_get, tasks_create, tasks_update	CRM task operations
Notes	notes_list, notes_create	Notes on entities
Pipelines	pipelines_list, pipelines_get, pipelines_list_statuses	Pipeline & status info
Associations	associations_get_linked, associations_link_entities	Entity relationships
Account	account_get, account_list_users, account_list_custom_fields	Account metadata
Batch	batch_create_leads, batch_create_contacts, batch_update_leads	Bulk operations
Analytics	analytics_get_events, analytics_get_pipeline_analytics, +1	CRM analytics
Unsorted	unsorted_list, unsorted_accept, unsorted_reject	Unsorted inbox

Getting amoCRM Credentials

1. Go to your amoCRM account → Settings → Integrations
2. Create a new integration (or use an existing one)
3. Copy the access token, client ID, and client secret
4. Your subdomain is the part before .amocrm.ru in your account URL

License

MIT