@theyahia/amocrm-mcp
This server is an MCP integration with amoCRM that lets AI assistants work with CRM data through natural-language commands.
Leads (deals): search, list, view, create, and update deals, including moving them between pipeline stages and changing budgets or responsible users
Contacts: search, list, view, and create contacts with phones, emails, and custom fields
Companies: search, list, and create companies with linked deals and contacts
Pipelines: view all sales funnels and their stages/statuses
Tasks: list, create, and complete tasks linked to leads, contacts, or companies with deadlines and result notes
Unsorted leads: view incoming unassigned requests and accept them into a pipeline
Notes: add notes and call logs to any entity
Search: universal search across leads, contacts, and companies
Events: retrieve activity logs like status changes, calls, and notes
Account info: get account details, users, task types, and settings
Resilience: automatic OAuth token refresh, rate limiting (~7 req/s), and retries with backoff
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@theyahia/amocrm-mcp Show me all leads in the Negotiation stage with contact info."
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.
🗄 Репозиторий заархивирован
Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро
@theyahia/mcp-core, единый CI, единый релизный конвейер.Актуальная версия того, что лежало здесь:
servers/amocrm/Пакет в npm прежний —
@theyahia/amocrm-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at
servers/amocrm/. The npm package@theyahia/amocrm-mcpis unchanged. Please open issues and pull requests there.
amoCRM MCP — сделки, контакты и воронка продаж через нейросеть
Если вы искали, как подключить amoCRM к ИИ-ассистенту, спросить состояние воронки обычными словами, завести сделку или найти контакт не открывая интерфейс — это оно. 19 инструментов для amoCRM: сделки, контакты, компании, воронки, задачи, примечания, поиск, события и неразобранное. OAuth 2.0 с автообновлением токена, ограничение 7 запросов/сек и повтор с экспоненциальной задержкой.
Related MCP server: amoCRM MCP Server
Установка
npx -y @theyahia/amocrm-mcpНастройка MCP
Добавьте в конфигурацию Claude Desktop, Cursor или любого другого MCP-клиента:
{
"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"
}
}
}
}Переменные окружения
Переменная | Обяз. | Описание |
| да | Поддомен вашего amoCRM (например, |
| да | OAuth access-токен |
| нет | OAuth refresh-токен (включает автообновление при 401) |
| нет | OAuth client ID (нужен для обновления токена) |
| нет | OAuth client secret (нужен для обновления токена) |
AMOCRM_DOMAINтоже принимается как алиасAMOCRM_SUBDOMAIN(обратная совместимость).
Инструменты (19)
Сделки
Инструмент | Описание |
| Поиск и список сделок с фильтрами (воронка, статусы, запрос). Подтягивает контакты и причины отказа. |
| Одна сделка по ID вместе со связанными контактами и элементами каталога. |
| Создать сделку с названием, бюджетом, воронкой, статусом и пользовательскими полями. |
| Обновить поля сделки — перевести между этапами, изменить бюджет, сменить ответственного. |
Контакты
Инструмент | Описание |
| Поиск контактов по имени, телефону, e-mail. |
| Один контакт со всеми пользовательскими полями. |
| Создать контакт с телефоном, e-mail и пользовательскими полями. |
Компании
Инструмент | Описание |
| Поиск компаний. Подтягивает связанные сделки и контакты. |
| Создать компанию с пользовательскими полями. |
Воронки
Инструмент | Описание |
| Все воронки продаж вместе с их статусами (этапами). |
Задачи
Инструмент | Описание |
| Список задач с фильтрами по сущности, выполненности и ответственному. |
| Создать задачу, привязанную к сделке, контакту или компании, с дедлайном. |
| Отметить задачу выполненной и добавить текст результата. |
Неразобранное
Инструмент | Описание |
| Входящие неразобранные заявки (формы, разбор почты). |
| Принять неразобранную заявку в воронку. |
Примечания
Инструмент | Описание |
| Добавить примечание (common, call_in, call_out, service_message) к любой сущности. |
Поиск
Инструмент | Описание |
| Универсальный поиск по сделкам, контактам и компаниям. |
События
Инструмент | Описание |
| Лента событий — смены статусов, звонки, примечания, связи. |
Аккаунт
Инструмент | Описание |
| Информация об аккаунте, пользователи, типы задач, настройки amojo. |
Демо-промпты
Обзор продаж:
«Покажи все сделки в воронке „Продажи“, которые сейчас на этапе „Переговоры“. С контактами.»
Работа с задачами:
«Создай задачу-перезвон по сделке #12345, дедлайн завтра в 10:00. Потом выведи все мои невыполненные задачи.»
Заведение нового клиента:
«Создай контакт „Иван Петров“ с телефоном +79001234567, потом компанию „Петров Солюшнс“ и сделку „Разработка сайта“ на 150 000 рублей в основной воронке.»
Как настроить OAuth 2.0
Откройте настройки аккаунта amoCRM:
https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/Создайте новую интеграцию (внешняя интеграция)
Укажите redirect URI:
https://YOUR_SUBDOMAIN.amocrm.ruСкопируйте Client ID и Client Secret
Авторизуйте интеграцию, чтобы получить первичный код авторизации
Обменяйте код на токены:
curl -X POST https://YOUR_SUBDOMAIN.amocrm.ru/oauth2/access_token \
-H "Content-Type: application/json" \
-d '{
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET",
"grant_type": "authorization_code",
"code": "YOUR_AUTH_CODE",
"redirect_uri": "https://YOUR_SUBDOMAIN.amocrm.ru"
}'Сохраните
access_tokenиrefresh_tokenиз ответаСервер сам обновит просроченный токен, если заданы
AMOCRM_REFRESH_TOKEN,AMOCRM_CLIENT_IDиAMOCRM_CLIENT_SECRET
Обработка ошибок
401 Unauthorized — автообновление токена, если настроены реквизиты для refresh, затем повтор запроса
429 Rate Limited — учитывает заголовок
Retry-After, ждёт и повторяет5xx — повтор с экспоненциальной задержкой (до 3 попыток)
Ограничение частоты — встроенная пауза 150 мс между запросами (~7 запросов/сек), чтобы укладываться в лимиты amoCRM
Разработка
git clone https://github.com/theYahia/amocrm-mcp.git
cd amocrm-mcp
npm install
npm run build
npm testЛицензия
MIT
Telegram: @vhodvai
Available Tools
19 toolsaccept_unsortedA
Accept an unsorted lead — moves it into a pipeline as a real lead. Optionally specify target pipeline, status, and responsible user.
Inputs: uid (required), user_id, status_id, pipeline_id.
add_noteA
Add a note to a lead, contact, or company. Supports common notes, incoming/outgoing call logs, and service messages.
Inputs: text (required), entity_id (required), entity_type (required), note_type.
complete_taskA
Mark a task as completed and add a result text. The result will appear in the entity's activity feed.
Inputs: task_id (required), result_text (required).
create_companyA
Create a new company in amoCRM. Use custom_fields_values for address, website, etc.
Inputs: name (required), responsible_user_id, custom_fields_values.
create_contactA
Create a new contact in amoCRM. Use custom_fields_values to set phone, email, and other fields.
Inputs: name, last_name, first_name, responsible_user_id, +1 more.
create_leadA
Create a new lead (deal) in amoCRM. Requires a name. Optionally set price, pipeline, status, responsible user, and custom fields.
Inputs: name (required), price, status_id, pipeline_id, +2 more.
create_taskA
Create a task linked to a lead, contact, or company. Set deadline (complete_till as Unix timestamp) and task type (1=Call, 2=Meeting, 3=Email).
Inputs: text (required), entity_id (required), entity_type (required), complete_till (required), +2 more.
get_accountA
Get current amoCRM account info — name, plan, users, task types, etc. Use 'with' to include users_groups, task_types, and amojo_id.
Inputs: with.
get_contactA
Get a single contact by ID with full details including custom fields (phone, email, etc.).
Inputs: contact_id (required), with.
get_leadA
Get a single lead by ID with full details. Use 'with' to include linked contacts and catalog elements.
Inputs: lead_id (required), with.
list_companiesA
Search and list companies in amoCRM. Use 'with' to embed linked leads and contacts.
Inputs: page, with, limit, query.
list_contactsB
Search and list contacts in amoCRM. Supports full-text search across name, phone, and email.
Inputs: page, with, limit, query.
list_eventsA
List events (activity log) in amoCRM. Filter by entity type, entity ID, or event type. Shows status changes, calls, notes, and other activities.
Inputs: page, type, limit, entity, +1 more.
list_leadsA
Search and list deals (leads) in amoCRM. Supports filtering by pipeline, statuses, and full-text search. Use 'with' to embed contacts or loss reasons.
Inputs: page, with, limit, query, +2 more.
list_pipelinesA
List all sales pipelines with their statuses (stages). Essential for understanding the sales funnel structure before creating or filtering leads.
Inputs: no named parameters.
list_tasksA
List tasks in amoCRM. Filter by entity (lead/contact/company), completion status, or responsible user.
Inputs: page, limit, entity_id, entity_type, +2 more.
list_unsortedA
List incoming unsorted leads (from forms, email parsing, etc.) that need to be accepted or declined.
Inputs: page, limit, pipeline_id.
searchA
Universal search across amoCRM — finds leads, contacts, and companies matching the query. Min 3 characters.
Inputs: query (required), limit.
update_leadA
Update an existing lead — change name, price, status, pipeline, responsible user, or custom fields. Useful for moving deals between stages.
Inputs: lead_id (required), name, price, status_id, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Each tool maps to a distinct resource and action, such as list_leads vs get_lead vs create_lead, and list_unsorted/accept_unsorted are clearly separate from regular lead tools. No two tools appear to do the same job.
Tool names consistently use lowercase snake_case verb_noun patterns like list_leads, create_contact, complete_task, and accept_unsorted. The bare 'search' is a reasonable exception for a universal action and does not break the overall convention.
At 19 tools, the set falls into the heavy 16-25 range and begins to feel borderline bloated, even though the CRM domain covers many entities. The organization by entity helps, but the count is above the ideal 3-15 sweet spot.
Core lead and task workflows are well covered, but contacts and companies lack update/delete operations, there is no get_company, and unsorted leads can only be accepted, not declined. These are notable lifecycle gaps that agents may need to work around.
Maintenance
Related MCP Connectors
Manage projects, tasks, time tracking, and team collaboration through natural language.
Operate Obriym CRM from your AI assistant: leads, deals, orders, catalog, stock, marketplaces.
A CRM you talk to: leads, deals and a pipeline board inside ChatGPT, Grok and other MCP clients.
Ask your Quickbase apps in plain language. Read-only by default; writes need human approval.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables users to interact with AmoCRM via Claude Desktop using natural language, with 17 tools for accessing CRM entities like leads, contacts, and pipelines.1834 PyPI1MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for amoCRM integration, enabling AI assistants to manage leads, contacts, companies, tasks, and more via natural language.4MIT
- FlicenseNot gradedqualityDmaintenanceAI-powered CRM assistant for Kommo/amoCRM that provides natural language management via Telegram bot and MCP protocol, enabling analytics, entity operations, and CRM setup.8-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with amoCRM, providing access to deals, contacts, companies, notes, tasks, and custom fields via natural language.MIT