amoCRM MCP Server
MCP server for the amoCRM (Kommo) API v4: leads, contacts, companies, tasks, pipelines, unsorted inbox and analytics
Install
pip install -e .
cp .env.example .env
python -m amocrm_mcpRun inside a clone of the repository. For SSE: AMO_TRANSPORT=sse AMO_PORT=8000 python -m amocrm_mcp.
This is third-party code. Review the repository files before installing.
What it does
The FastMCP-based server gives the agent 36 amoCRM tools. The agent can search, create and update leads, contacts, companies and tasks, add notes, link entities and run batch creates and updates. It can read pipelines with statuses, account users and custom fields, events and pipeline analytics. Incoming unsorted requests can be accepted or rejected. The server refreshes the OAuth token and respects rate limits.
Who it is for. Sales teams and integrators working in amoCRM who want an agent to handle routine work.
Good fit when
- You need to find a lead or contact and update its status without the UI
- You need to process incoming unsorted requests
- You need a pipeline and events summary for a period
Not a fit when
- The agent must not change live CRM data
- You need a packaged install: the server installs only from source
Example request
Find the Romashka deal in amoCRM, move it to the Contract stage and create a task for me to call tomorrowLimitations
Requires the account subdomain and an amoCRM integration OAuth token, plus client id, client secret and refresh token for auto-refresh. There is no PyPI package; install with pip install -e . from a clone. The repo was published in a single commit and has not been updated since. The tool list has no entity deletion.
How to disable. Remove the amocrm block from your MCP client config and disable the integration in amoCRM settings.
MCP
- Transport
- stdio, sse
- Authentication
- OAuth
| Environment variables | |
|---|---|
| AMO_SUBDOMAIN required | amoCRM account subdomain |
| AMO_ACCESS_TOKEN required, secret | Integration OAuth access token |
| AMO_CLIENT_ID | For token auto-refresh |
| AMO_CLIENT_SECRET secret | For token auto-refresh |
| AMO_REFRESH_TOKEN secret | For token auto-refresh |
Security check
- Creates and bulk-updates leads, contacts and companies in the live CRM
- Accepts and rejects incoming requests
- Stores OAuth tokens with access to the customer base
README in short
The README briefly lists 36 tools in 11 groups and technical details: OAuth token refresh with disk persistence, rate limiting with 429 backoff and flattened HAL+JSON responses. It installs from source, configures via .env and runs over stdio or SSE. It includes a Claude Desktop config and steps for getting amoCRM credentials. MIT license.
FAQ
Where do I get the token?
In amoCRM integration settings: create an integration and copy the access token, client ID and client secret.
Does it work with Kommo?
Yes, it uses API v4, shared by amoCRM and Kommo.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
E-Commerce Skills
E-Commerce Skills by Nexscope
A large set of text skills for Amazon, Shopify, eBay, Etsy, TikTok Shop and Walmart sellers: pricing, listings, ads and growth
153 cross-border e-commerce skills via the LinkFox API: Amazon, Ozon, TikTok Shop, 1688, keywords, ads and patents
An MCP server for Bitrix24 CRM contacts and deals via an inbound webhook: search, lists and deal stage changes