amoCRM MCP Server on FastMCP
amoCRM MCP Server
A FastMCP-based MCP server with 39 tools across 11 amoCRM domains: leads, contacts, analytics and batch operations, deployed as one Vercel project per account
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- Creates and updates leads, contacts and companies
- Stores the OAuth client_secret and refresh_token for auto-refresh
Install
Manual install
pip install -e .
cp .env.example .envInstalling the server from source before filling in .env.
This is third-party code. Review the repository files before installing.
What it does
The server is built on the FastMCP library and covers amoCRM's API v4 with 39 tools across 11 domains: leads, contacts, companies, tasks, notes, pipelines, associations, account, batch, unsorted and analytics. Tokens refresh automatically with disk persistence, there is a long-lived token mode for simple single-account setups, request rate limiting at 7 per second with 429 backoff, HAL and JSON normalization, and a consistent data-or-error response envelope. It supports stdio, SSE and streamable-http transports. The README describes a production pattern: one Vercel project per amoCRM account, with environment variables in the project settings.
Who it is for. For developers who need a full-featured amoCRM MCP server with a ready Vercel deployment and support for multiple transports.
Good fit when
- You need leads, contacts, companies, tasks, analytics and batch operations in one server
- You need a remote HTTP deployment on Vercel, not just local stdio
- You need built-in rate limiting and automatic OAuth token refresh
Not a fit when
- You need one amoCRM account shared by several clients at once: the README's production pattern is one Vercel project per account
- You do not want a separate Vercel deployment and prefer a purely local server
Example request
Pull analytics on deals in my amoCRM pipeline for this monthLimitations
For production the README explicitly describes a one-Vercel-project-per-amoCRM-account pattern, so multiple accounts need multiple deployments. Service health is checked via a separate /healthz endpoint that you need to monitor yourself. It requires your own amoCRM OAuth integration with a client_id, client_secret and refresh_token, or a long-lived token.
How to disable. Remove the amocrm server from your MCP client config and stop or delete the Vercel project if you used the cloud deployment.
MCP
- Transport
- stdio, sse, http
- Authentication
- OAuth
| Environment variables | |
|---|---|
| AMO_SUBDOMAIN required | The amoCRM account subdomain. |
| AMO_ACCESS_TOKEN required, secret | A long-lived access token for the simple single-account mode. |
| AMO_CLIENT_ID secret | The integration ID for automatic token refresh, together with CLIENT_SECRET and REFRESH_TOKEN. |
Security check
- Creates and updates leads, contacts and companies
- Stores the OAuth client_secret and refresh_token for auto-refresh
README in short
The README lists 39 tools across 11 domains, features like rate limiting, HAL normalization and three transports, gives a pip install -e . setup, .env configuration with minimal and full variable sets, three transport-based launch methods, a Claude Desktop config, and a Vercel deployment section with project environment variables and /mcp and /healthz endpoints.
FAQ
Can one server serve multiple amoCRM accounts?
The README describes a one-Vercel-project-per-account production pattern, so multiple accounts need multiple deployments.
Which transports are supported?
stdio for local runs, plus SSE and streamable-http via the AMO_TRANSPORT and AMO_PORT variables for network access.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
Yandex Kit skills for store management
kit-skills
Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex
YouGile MCP by Indalo
YouGile MCP
Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit
Bitrix24 portal MCP server
MCP-сервер портала Битрикс24
Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail