Skip to main content
Glama
amocrm-kommo-mcp

amocrm-kommo-mcp

amocrm-kommo-mcp — amoCRM и Kommo для ИИ-агентов

penmadebykisss/amocrm-kommo-mcp MCP server CI

MCP-сервер, который подключает Claude, Cursor и других ИИ-ассистентов к amoCRM (и международной версии Kommo): сделки, контакты, задачи и примечания — и аналитика отдела продаж, которую руководитель обычно собирает руками: отчёт по воронке с конверсией и менеджерами, зависшие сделки без движения, просроченные задачи.

Спросите ассистента:

  • «Как идут продажи за сентябрь? Кто из менеджеров лучше закрывает?»

  • «Какие сделки зависли больше недели и на какую сумму?»

  • «Что у Анны просрочено сегодня?»

  • «Найди клиента +7 900 123-45-67 и подготовь меня к звонку»

  • «Создай сделку „Сайт для кафе“ на 90 000 с контактом Иван, +7 900…, и поставь задачу перезвонить завтра в 11»

Инструменты

Инструмент

Что делает

crm_account

Аккаунт, менеджеры, воронки и этапы с id

crm_search_leads

Поиск сделок по тексту, воронке, этапу, менеджеру, периоду

crm_get_lead

Карточка сделки: контакты с телефонами, компания, открытые задачи, примечания

crm_find_contact

Поиск контакта по имени, телефону, e-mail

crm_tasks

Открытые, просроченные или сегодняшние задачи

crm_pipeline_report

Отчёт по воронке: этапы, выиграно/проиграно, конверсия, средний чек и цикл, рейтинг менеджеров

crm_stale_leads

Зависшие сделки: без изменений N дней, без задачи или с просроченной задачей

crm_create_lead ✏️

Сделка сразу с контактом, компанией, тегами и примечанием

crm_update_lead ✏️

Этап, бюджет, ответственный, теги, доп. поля; закрыть успешно/неуспешно

crm_add_note ✏️

Примечание в сделку, контакт или компанию

crm_create_task ✏️

Задача со сроком и ответственным

crm_complete_task ✏️

Закрыть задачу с результатом

✏️ — изменяют данные в CRM; ассистент должен показать, что запишет, и получить ваше согласие.

Related MCP server: KommoMCP

Подключение

  1. В amoCRM: amoМаркет → ⋯ (справа вверху) → Создать интеграцию → Внешняя интеграция, отметьте доступ ко всем данным, сохраните. На вкладке Ключи и доступы нажмите Сгенерировать долгосрочный токен.

  2. Домен аккаунта — из адресной строки: 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-mcp

Cursor, 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-mcp

Ready-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 tools
crm_accountАккаунт, воронки и менеджерыA
Read-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Завершить задачуA
Idempotent

Закрывает задачу по 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Найти контактA
Read-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Карточка сделкиA
Read-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Отчёт по воронке продажA
Read-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Поиск сделокA
Read-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Зависшие сделкиA
Read-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ЗадачиA
Read-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Изменить сделкуA
Idempotent

Частично обновляет существующую сделку: передавайте только поля, которые меняются. Перевод по воронке — 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

    A4.6/5.0

    Scored across 12 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    12 tools cover the core CRM workflows without redundancy and sit comfortably in the typical 3-15 range for a domain integration.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to autonomously interact with Kommo CRM, providing tools for managing pipelines, leads, contacts, and custom fields via the Kommo API v4.
      27
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      AI-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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to interact with amoCRM, providing access to deals, contacts, companies, notes, tasks, and custom fields via natural language.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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