amocrm-kommo-mcp
Connects AI assistants to amoCRM/Kommo to inspect, update, and analyze sales data.
View account details, users, pipelines, and stages with IDs.
Search leads and contacts by text, phone, email, pipeline, stage, manager, or date.
Open full lead cards with contacts, company, open tasks, and recent notes.
Create and update leads, including contacts, companies, tags, budgets, stages, and custom fields.
Add notes to leads, contacts, or companies.
List open, overdue, or today’s tasks; create and complete tasks.
Generate sales analytics: pipeline conversion, won/lost/open totals, average deal size and cycle, manager leaderboard.
Find stale/at-risk deals with no activity, no task, or overdue tasks.
Respect amoCRM rate limits and require confirmation before modifying CRM data.
amocrm-kommo-mcp — amoCRM и Kommo для ИИ-агентов
MCP-сервер, который подключает Claude, Cursor и других ИИ-ассистентов к amoCRM (и международной версии Kommo): сделки, контакты, задачи и примечания — и аналитика отдела продаж, которую руководитель обычно собирает руками: отчёт по воронке с конверсией и менеджерами, зависшие сделки без движения, просроченные задачи.
Спросите ассистента:
«Как идут продажи за сентябрь? Кто из менеджеров лучше закрывает?»
«Какие сделки зависли больше недели и на какую сумму?»
«Что у Анны просрочено сегодня?»
«Найди клиента +7 900 123-45-67 и подготовь меня к звонку»
«Создай сделку „Сайт для кафе“ на 90 000 с контактом Иван, +7 900…, и поставь задачу перезвонить завтра в 11»
Инструменты
Инструмент | Что делает |
| Аккаунт, менеджеры, воронки и этапы с id |
| Поиск сделок по тексту, воронке, этапу, менеджеру, периоду |
| Карточка сделки: контакты с телефонами, компания, открытые задачи, примечания |
| Поиск контакта по имени, телефону, e-mail |
| Открытые, просроченные или сегодняшние задачи |
| Отчёт по воронке: этапы, выиграно/проиграно, конверсия, средний чек и цикл, рейтинг менеджеров |
| Зависшие сделки: без изменений N дней, без задачи или с просроченной задачей |
| Сделка сразу с контактом, компанией, тегами и примечанием |
| Этап, бюджет, ответственный, теги, доп. поля; закрыть успешно/неуспешно |
| Примечание в сделку, контакт или компанию |
| Задача со сроком и ответственным |
| Закрыть задачу с результатом |
✏️ — изменяют данные в CRM; ассистент должен показать, что запишет, и получить ваше согласие.
Related MCP server: KommoMCP
Подключение
В amoCRM: amoМаркет → ⋯ (справа вверху) → Создать интеграцию → Внешняя интеграция, отметьте доступ ко всем данным, сохраните. На вкладке Ключи и доступы нажмите Сгенерировать долгосрочный токен.
Домен аккаунта — из адресной строки:
mycompany.amocrm.ru(илиmycompany.kommo.com).
Нужен Node.js 18+.
Claude Desktop
{
"mcpServers": {
"amocrm": {
"command": "npx",
"args": ["-y", "github:penmadebykisss/amocrm-kommo-mcp"],
"env": { "AMOCRM_DOMAIN": "mycompany.amocrm.ru", "AMOCRM_TOKEN": "долгосрочный токен" }
}
}
}Claude Code
claude mcp add amocrm -e AMOCRM_DOMAIN=mycompany.amocrm.ru -e AMOCRM_TOKEN=токен -- npx -y github:penmadebykisss/amocrm-kommo-mcpCursor, Windsurf и другие
Команда npx, аргументы -y github:penmadebykisss/amocrm-kommo-mcp, переменные AMOCRM_DOMAIN и AMOCRM_TOKEN.
Облачная версия — без установки
Не хотите ставить Node.js и хранить токен у себя? Есть облачный доступ: вы получаете адрес и ключ и подключаете сервер в Claude, Cursor или ChatGPT как удалённый MCP. Подписка — пишите в Telegram @penmadebykisss. Как развернуть такой сервер самому — docs/cloud.md.
Ограничения
Лимит amoCRM — 7 запросов в секунду; сервер сам выдерживает интервал и повторяет запрос при 429.
Отчёт по воронке считает до 10 000 сделок за период (параметр
max_leads).
Проверка
npm test # мок-сервер amoCRM API v4, реальный аккаунт не нуженНужна настройка или доработка?
Подключу этот сервер под ключ: установка, настройка под ваши данные и процессы, доработка под нестандартные поля, ежедневные сводки. Пишите в Telegram @penmadebykisss или оставьте заявку на penmadebykisss.github.io.
Need help setting this up or a custom MCP server? Telegram @penmadebykisss.
English
amocrm-kommo-mcp connects AI assistants to amoCRM / Kommo CRM: search and edit leads, create a lead with its
contact and company in one call, contacts lookup by phone or e-mail, notes, tasks — plus sales analytics: pipeline
report (stage totals, win rate, average deal and cycle, manager leaderboard), stale deals with no activity or no
scheduled task, overdue tasks. Set AMOCRM_DOMAIN (e.g. mycompany.kommo.com) and AMOCRM_TOKEN (long-lived token
of a private integration).
npx -y github:penmadebykisss/amocrm-kommo-mcpReady-made agent skill: Kommo / amoCRM Sales Assistant on Agensi — free SKILL.md with usage rules and configs for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and Codex.
Смотрите также
ru-business-mcp — проверка контрагентов, курсы ЦБ, пени, производственный календарь
rf-marketplaces-mcp — аналитика Wildberries
Лицензия
MIT
Available Tools
12 toolscrm_accountАккаунт, воронки и менеджерыARead-onlyIdempotent
Справочник аккаунта amoCRM/Kommo: account (название, поддомен, валюта), users (id, name, email, active) и pipelines со statuses (id, name, type: open/won/lost). Вызывайте первым в разговоре: id воронок, этапов и менеджеров нужны фильтрам crm_search_leads, crm_tasks, crm_pipeline_report и записи в crm_create_lead / crm_update_lead. Результат кэшируется на 10 минут, повторно вызывать не нужно. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.
Inputs: no named parameters.
crm_add_noteДобавить примечаниеA
Добавляет обычное текстовое примечание в ленту сделки, контакта или компании: итог звонка, договорённости, комментарий. Не меняет поля сущности (для этого crm_update_lead) и не ставит задач (crm_create_task). Возвращает note_id. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Изменяет данные в CRM: покажите пользователю, что будет записано, и получите согласие.
Inputs: text (required), entity_id (required), entity_type.
crm_complete_taskЗавершить задачуAIdempotent
Закрывает задачу по id с текстом результата (например «Дозвонился, отправил КП»); результат виден в ленте сделки. id берите из crm_tasks или crm_get_lead. Закрытую задачу этим инструментом не открыть. Возвращает completed. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Изменяет данные в CRM: покажите пользователю, что будет записано, и получите согласие.
Inputs: id (required), result (required).
crm_create_leadСоздать сделку с контактомA
Создаёт сделку одним запросом вместе с новым контактом (имя, телефон, e-mail), компанией и тегами; при note добавляет примечание. Без pipeline_id/status_id сделка встаёт в первый этап основной воронки; id бери из crm_account. amoCRM может склеить контакт с существующим — тогда merged_with_existing=true. Возвращает lead_id, contact_id, company_id. Чтобы изменить уже существующую сделку, используйте crm_update_lead; не создавайте дубль — сначала проверьте crm_find_contact. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Изменяет данные в CRM: покажите пользователю, что будет записано, и получите согласие.
Inputs: name (required), note, tags, email, +7 more.
crm_create_taskПоставить задачуA
Ставит задачу со сроком: звонок или встреча, привязанная к сделке, контакту или компании (или без привязки), с ответственным. Дата без времени означает 18:00 по часовому поясу сервера; для точного времени передайте ISO с зоной, например 2026-10-01T11:00:00+03:00. Возвращает task_id и due. Закрыть задачу — crm_complete_task, посмотреть задачи — crm_tasks. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Изменяет данные в CRM: покажите пользователю, что будет записано, и получите согласие.
Inputs: due (required), text (required), entity_id, task_type, +2 more.
crm_find_contactНайти контактARead-onlyIdempotent
Ищет контакты по имени, телефону (в любом формате) или e-mail — например при входящем звонке или письме. Возвращает contacts: id, name, phones, emails, responsible, lead_ids (связанные сделки), company_ids, custom_fields. Дальше откройте сделку через crm_get_lead; искать сами сделки удобнее crm_search_leads. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.
Inputs: query (required), limit.
crm_get_leadКарточка сделкиARead-onlyIdempotent
Полная карточка одной сделки по id: всё из crm_search_leads плюс contacts (телефоны, e-mail, доп. поля, is_main), company, open_tasks (со сроком и флагом overdue) и последние notes (текст, автор, дата). Используйте перед звонком или письмом клиенту, чтобы понять историю; id берите из crm_search_leads или crm_find_contact. Несуществующий id вернёт ошибку «не найдена». Делает 3–5 запросов к API. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.
Inputs: id (required), notes_limit.
crm_pipeline_reportОтчёт по воронке продажARead-onlyIdempotent
Аналитика отдела продаж по одной воронке для сделок, созданных за период (по умолчанию 30 дней): stages (сделки и бюджет по этапам), won/lost/open, win_rate_pct (успешные / закрытые), avg_deal, avg_cycle_days (от создания до успеха) и managers — рейтинг менеджеров по выигранному бюджету. Используйте для «как идут продажи», «кто лучше закрывает», сравнения месяцев; конкретные сделки ищите crm_search_leads, проблемные — crm_stale_leads. Загружает до max_leads сделок (truncated=true, если упёрлись), на больших периодах может занять десятки секунд. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.
Inputs: max_leads, created_to, pipeline_id, created_from.
crm_search_leadsПоиск сделокARead-onlyIdempotent
Ищет сделки по тексту (название, телефон, e-mail, значения полей) и фильтрам: воронка, этап, ответственный, период создания. Возвращает count, total_budget и leads (id, name, price, pipeline, status, responsible, даты, tags, contact_ids, custom_fields), свежие изменения первыми. Используйте, чтобы найти сделку или список сделок; полная карточка с контактами и задачами — crm_get_lead, агрегированная аналитика — crm_pipeline_report, зависшие сделки — crm_stale_leads. Этап фильтруется только вместе с pipeline_id (иначе ошибка). Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.
Inputs: limit, query, status_id, created_to, +3 more.
crm_stale_leadsЗависшие сделкиARead-onlyIdempotent
Открытые сделки под риском: без изменений days+ дней, без запланированной задачи или с просроченной задачей. Возвращает count, at_risk_budget и leads (id, name, price, stage, pipeline, responsible, idle_days, reasons), сначала самые дорогие. Используйте для «что зависло», ежедневной ревизии воронки и напоминаний менеджерам; общая картина — crm_pipeline_report, задачи — crm_tasks. Смотрит до 3000 открытых сделок. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.
Inputs: days, limit, pipeline_id, include_no_task, +1 more.
crm_tasksЗадачиARead-onlyIdempotent
Незавершённые задачи: scope=open — все, overdue — просроченные, today — со сроком до конца сегодняшнего дня; фильтры по ответственному и по сделке. Возвращает count и tasks (id, text, due, overdue, responsible, entity_type, entity_id), ближайшие сроки первыми. Используйте для «что просрочено у менеджера» и планирования дня; поставить задачу — crm_create_task, закрыть — crm_complete_task. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Только чтение.
Inputs: limit, scope, lead_id, responsible_user_id.
crm_update_leadИзменить сделкуAIdempotent
Частично обновляет существующую сделку: передавайте только поля, которые меняются. Перевод по воронке — status_id (+ pipeline_id при смене воронки), закрыть успешно — status_id 142, проиграно — 143; tags заменяют весь набор тегов; custom_fields — [{field_id, value}]. Возвращает updated и список changed. Без изменяемых полей — ошибка. Новую сделку создаёт crm_create_lead, примечание — crm_add_note. Требует AMOCRM_DOMAIN и AMOCRM_TOKEN; лимит amoCRM 7 запросов/с соблюдается автоматически. Изменяет данные в CRM: покажите пользователю, что будет записано, и получите согласие.
Inputs: id (required), name, tags, price, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct resource and action, with descriptions cross-referencing neighbors (e.g., crm_search_leads vs crm_stale_leads, crm_tasks vs crm_pipeline_report). No two tools appear to do the same thing.
All tools share the crm_ prefix and snake_case convention, but a few are noun-only (crm_account, crm_tasks, crm_pipeline_report) instead of following the dominant verb_noun pattern, a minor deviation.
12 tools cover the core CRM workflows without redundancy and sit comfortably in the typical 3-15 range for a domain integration.
The sales lifecycle is well covered (lead search/get/create/update, contact lookup, notes, task management, pipeline analytics), but there is no separate contact update/delete, task reschedule, or lead delete—minor gaps that agents can work around.
Maintenance
Related MCP Connectors
Sales CRM: leads, calls, texts, email campaigns and deals, plus an AI caller, for AI agents.
Your own CRM, fully customizable and agent-driven. Start with contacts, companies and a sales pipeli
Agentic CRM for teams that sell in chat: unified inbox, contacts, deals, projects, tasks, reports.
CRM, inbox, meetings, revenue intelligence, analytics and automations for AI agents.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables AI assistants to autonomously interact with Kommo CRM, providing tools for managing pipelines, leads, contacts, and custom fields via the Kommo API v4.271-
- 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
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage omnichannel CRM data (WhatsApp, Instagram, Facebook) via the official API, including leads, deals, pipelines, activities, tags, products, conversations, lists, attachments, and notes.MIT