Amocrm Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.1Updated Oct 24, 2026

MCP server for amoCRM API — leads, contacts, pipelines. Auth: Bearer token.

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Local MCP server for amoCRM that lets an assistant read and manage leads, contacts, companies, pipelines, tasks, notes and events in a CRM account.

What you can do
Search, list and read leads, contacts and companies, including related records and loss reasons, plus a universal search across them all and the event feed and account info with users and settings. Create and update leads, contacts and companies, moving deals between stages, changing budgets or responsible users. List sales pipelines with their stages. List, create and complete tasks tied to a deal, contact or company, with deadlines and result text. List incoming unsorted requests and accept them into a pipeline, and add notes of several types to any entity.
When to use it
Useful when you want to query or update an amoCRM sales pipeline in plain language from an MCP client: reviewing deals at a stage, creating a contact, company and deal together, or managing follow-up tasks without opening the CRM interface.
Requirements
Runs locally via npx as an npm package on Node.js. Needs an amoCRM account subdomain and OAuth 2.0 credentials: an access token, and optionally a refresh token, client ID and client secret for automatic token refresh. Network access to the amoCRM API.
Before you install
Requires OAuth credentials for your CRM account, including a client secret and refresh token; keep them out of shared configs. The server can create and modify records (leads, contacts, companies, tasks, notes) and accept unsorted requests into a pipeline, so changes affect real CRM data. The README states the repository is archived and development has moved elsewhere, though the npm package is said to be unchanged.

Installation

In SourceWeft

  1. Open Amocrm Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

Разработка переехала в 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 запросов/сек и повтор с экспоненциальной задержкой.

Установка

bash
npx -y @theyahia/amocrm-mcp

Настройка MCP

Добавьте в конфигурацию Claude Desktop, Cursor или любого другого MCP-клиента:

json
{  "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. Обменяйте код на токены:
bash
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

Разработка

bash
git clone https://github.com/theYahia/amocrm-mcp.gitcd amocrm-mcpnpm installnpm run buildnpm test

Лицензия

MIT

Telegram: @vhodvai

Source: README.md at commit a969508

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts