How do I use amoCRM MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@amoCRM MCP Server list the 5 most recent leads and their current pipeline status" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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