amocrm-mcp

Production-grade MCP server for amoCRM API. 19 tools covering leads, contacts, companies, pipelines, tasks, notes, search, events, and unsorted leads. OAuth 2.0 with automatic token refresh. Rate limiting (7 req/sec). Retry with exponential backoff.

npx -y @theyahia/amocrm-mcp

Add to your Claude Desktop, Cursor, or any MCP client config:

{
  "mcpServers": {
    "amocrm": {
      "command": "npx",
      "args": ["-y", "@theyahia/amocrm-mcp"],
      "env": {
        "AMOCRM_SUBDOMAIN": "mycompany",
        "AMOCRM_ACCESS_TOKEN": "your-access-token",
        "AMOCRM_REFRESH_TOKEN": "your-refresh-token",
        "AMOCRM_CLIENT_ID": "your-client-id",
        "AMOCRM_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

| Variable | Required | Description | |----------|----------|-------------| | AMOCRM_SUBDOMAIN | Yes | Your amoCRM subdomain (e.g. mycompany from mycompany.amocrm.ru) | | AMOCRM_ACCESS_TOKEN | Yes | OAuth access token | | AMOCRM_REFRESH_TOKEN | No | OAuth refresh token (enables auto-refresh on 401) | | AMOCRM_CLIENT_ID | No | OAuth client ID (required for token refresh) | | AMOCRM_CLIENT_SECRET | No | OAuth client secret (required for token refresh) |

> AMOCRM_DOMAIN is also accepted as an alias for AMOCRM_SUBDOMAIN (backwards compatibility).

| Tool | Description | |------|-------------| | list_leads | Search and list deals with filters (pipeline, statuses, query). Embed contacts, loss reasons. | | get_lead | Get a single lead by ID with linked contacts and catalog elements. | | create_lead | Create a new lead with name, price, pipeline, status, custom fields. | | update_lead | Update lead fields — move between stages, change price, reassign. |

| Tool | Description | |------|-------------| | list_contacts | Search contacts by name, phone, email.