Skip to main content
Glama
@theyahia/amocrm-mcp

@theyahia/amocrm-mcp

by theYahia

🗄 Репозиторий заархивирован

Разработка переехала в 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-mcp is 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_SUBDOMAIN

да

Поддомен вашего amoCRM (например, mycompany из mycompany.amocrm.ru)

AMOCRM_ACCESS_TOKEN

да

OAuth access-токен

AMOCRM_REFRESH_TOKEN

нет

OAuth refresh-токен (включает автообновление при 401)

AMOCRM_CLIENT_ID

нет

OAuth client ID (нужен для обновления токена)

AMOCRM_CLIENT_SECRET

нет

OAuth client secret (нужен для обновления токена)

AMOCRM_DOMAIN тоже принимается как алиас AMOCRM_SUBDOMAIN (обратная совместимость).

Инструменты (19)

Сделки

Инструмент

Описание

list_leads

Поиск и список сделок с фильтрами (воронка, статусы, запрос). Подтягивает контакты и причины отказа.

get_lead

Одна сделка по ID вместе со связанными контактами и элементами каталога.

create_lead

Создать сделку с названием, бюджетом, воронкой, статусом и пользовательскими полями.

update_lead

Обновить поля сделки — перевести между этапами, изменить бюджет, сменить ответственного.

Контакты

Инструмент

Описание

list_contacts

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

get_contact

Один контакт со всеми пользовательскими полями.

create_contact

Создать контакт с телефоном, e-mail и пользовательскими полями.

Компании

Инструмент

Описание

list_companies

Поиск компаний. Подтягивает связанные сделки и контакты.

create_company

Создать компанию с пользовательскими полями.

Воронки

Инструмент

Описание

list_pipelines

Все воронки продаж вместе с их статусами (этапами).

Задачи

Инструмент

Описание

list_tasks

Список задач с фильтрами по сущности, выполненности и ответственному.

create_task

Создать задачу, привязанную к сделке, контакту или компании, с дедлайном.

complete_task

Отметить задачу выполненной и добавить текст результата.

Неразобранное

Инструмент

Описание

list_unsorted

Входящие неразобранные заявки (формы, разбор почты).

accept_unsorted

Принять неразобранную заявку в воронку.

Примечания

Инструмент

Описание

add_note

Добавить примечание (common, call_in, call_out, service_message) к любой сущности.

Поиск

Инструмент

Описание

search

Универсальный поиск по сделкам, контактам и компаниям.

События

Инструмент

Описание

list_events

Лента событий — смены статусов, звонки, примечания, связи.

Аккаунт

Инструмент

Описание

get_account

Информация об аккаунте, пользователи, типы задач, настройки amojo.

Демо-промпты

Обзор продаж:

«Покажи все сделки в воронке „Продажи“, которые сейчас на этапе „Переговоры“. С контактами.»

Работа с задачами:

«Создай задачу-перезвон по сделке #12345, дедлайн завтра в 10:00. Потом выведи все мои невыполненные задачи.»

Заведение нового клиента:

«Создай контакт „Иван Петров“ с телефоном +79001234567, потом компанию „Петров Солюшнс“ и сделку „Разработка сайта“ на 150 000 рублей в основной воронке.»

Как настроить OAuth 2.0

  1. Откройте настройки аккаунта amoCRM: https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/

  2. Создайте новую интеграцию (внешняя интеграция)

  3. Укажите redirect URI: https://YOUR_SUBDOMAIN.amocrm.ru

  4. Скопируйте Client ID и Client Secret

  5. Авторизуйте интеграцию, чтобы получить первичный код авторизации

  6. Обменяйте код на токены:

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"
  }'
  1. Сохраните access_token и refresh_token из ответа

  2. Сервер сам обновит просроченный токен, если заданы 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 tools
accept_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.

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

    A3.7/5.0

    Scored across 19 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables users to interact with AmoCRM via Claude Desktop using natural language, with 17 tools for accessing CRM entities like leads, contacts, and pipelines.
      18
      34 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for amoCRM integration, enabling AI assistants to manage leads, contacts, companies, tasks, and more via natural language.
      4
      MIT
    • 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