Skip to main content
Glama

bitrix24-mcp — Битрикс24 для ИИ-агентов

penmadebykisss/bitrix24-mcp MCP server CI

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

Подключается за минуту через входящий вебхук — без приложения в маркете и без OAuth.

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

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

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

  • «Что просрочено у менеджеров на сегодня?»

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

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

Инструменты

Инструмент

Что делает

b24_portal

Сотрудники, воронки сделок и стадии с id и признаком won/lost

b24_search_deals

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

b24_get_deal

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

b24_find_contact

Поиск контакта по телефону (формат не важен), e-mail или имени + его открытые сделки

b24_tasks

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

b24_pipeline_report

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

b24_stale_deals

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

b24_create_deal ✏️

Сделка сразу с новым или существующим контактом

b24_update_deal ✏️

Стадия, сумма, ответственный, название, описание

b24_create_lead ✏️

Лид (входящая заявка) с телефоном, e-mail и источником

b24_add_comment ✏️

Комментарий в таймлайн сделки, лида, контакта или компании

b24_create_task ✏️

Задача сотруднику со сроком и привязкой к сделке/лиду/контакту

b24_complete_task ✏️

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

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

Related MCP server: Bitrix24 MCP Server

Подключение

  1. В Битрикс24: Разработчикам → Другое → Входящий вебхук. Отметьте права CRM (crm), Задачи (task) и Пользователи (user), сохраните.

  2. Скопируйте адрес вебхука вида https://ваш-портал.bitrix24.ru/rest/1/abc123xyz/ — это BITRIX24_WEBHOOK_URL.

Вебхук действует от имени создавшего его сотрудника и видит то же, что он. Храните адрес как пароль.

Нужен Node.js 18+.

Claude Desktop

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "github:penmadebykisss/bitrix24-mcp"],
      "env": { "BITRIX24_WEBHOOK_URL": "https://ваш-портал.bitrix24.ru/rest/1/abc123xyz/" }
    }
  }
}

Claude Code

claude mcp add bitrix24 -e BITRIX24_WEBHOOK_URL=https://ваш-портал.bitrix24.ru/rest/1/abc123xyz/ -- npx -y github:penmadebykisss/bitrix24-mcp

Cursor, Windsurf и другие

Команда npx, аргументы -y github:penmadebykisss/bitrix24-mcp, переменная BITRIX24_WEBHOOK_URL.

Docker

docker build -t bitrix24-mcp .
docker run -i --rm -e BITRIX24_WEBHOOK_URL=https://ваш-портал.bitrix24.ru/rest/1/abc123xyz/ bitrix24-mcp

Ограничения

  • Лимит REST API для вебхуков — около 2 запросов в секунду; сервер сам выдерживает интервал и повторяет запрос при QUERY_LIMIT_EXCEEDED.

  • Отчёт по воронке считает до 2000 сделок за период, поиск зависших — до 1000 открытых сделок.

  • Коробочная версия Битрикс24 тоже поддерживается — адрес вебхука будет на вашем домене.

Проверка

npm test   # мок REST API Битрикс24, реальный портал не нужен

Нужна настройка или доработка?

Подключу этот сервер под ключ: вебхук и права, настройка под ваши воронки и поля, ежедневные сводки руководителю в Telegram, интеграции Битрикс24 с другими сервисами. Пишите в Telegram @penmadebykisss или оставьте заявку на penmadebykisss.github.io.

Need help setting this up or a custom MCP server? Telegram @penmadebykisss.

English

bitrix24-mcp connects AI assistants to Bitrix24 CRM via an inbound webhook: search, read and edit deals, create deals with contacts, leads, contact lookup by phone or e-mail (duplicate search), timeline comments, tasks — plus sales analytics: pipeline report (stage totals, win rate, average cycle, manager leaderboard), stale deals with no activity and no open tasks, overdue tasks by employee. Set BITRIX24_WEBHOOK_URL (Developer resources → Other → Inbound webhook with crm, task, user scopes).

npx -y github:penmadebykisss/bitrix24-mcp

Ready-made agent skill: Bitrix24 CRM Sales Assistant on Agensi — free SKILL.md with usage rules and configs for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and Codex.

Смотрите также

Лицензия

MIT

Available Tools

13 tools
b24_add_commentКомментарий в таймлайнA

Добавляет комментарий в таймлайн сделки, лида, контакта или компании — итог звонка, договорённости, заметка. Возвращает comment_id. Каждый вызов добавляет новый комментарий. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Inputs: text (required), entity_id (required), entity_type.

b24_complete_taskЗакрыть задачуA
Idempotent

Отмечает задачу выполненной, при желании с комментарием-результатом. Повторный вызов для уже закрытой задачи не меняет данные. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Inputs: id (required), result.

b24_create_dealСоздать сделкуA

Создаёт сделку в Битрикс24, при необходимости вместе с новым контактом (contact_name + phone/email) или привязывает существующий contact_id. Возвращает deal_id и contact_id. Воронку и стадию берите из b24_portal; без них сделка попадёт в первую стадию общей воронки. Перед созданием проверьте b24_find_contact, чтобы не плодить дубли контактов. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Inputs: title (required), email, phone, amount, +7 more.

b24_create_leadСоздать лидA

Создаёт лид (входящую заявку) в Битрикс24: название, имя, телефон, e-mail, сумма, источник, комментарий. Возвращает lead_id. Используйте для заявок, которые ещё не квалифицированы; для подтверждённой продажи — b24_create_deal. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Inputs: title (required), name, email, phone, +4 more.

b24_create_taskПоставить задачуA

Ставит задачу сотруднику, при желании привязывает к сделке, лиду или контакту (появится в карточке CRM). Возвращает task_id. Если ответственный не указан, задача ставится владельцу вебхука. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Inputs: title (required), deal_id, lead_id, deadline, +3 more.

b24_find_contactНайти контактA
Read-onlyIdempotent

Находит контакты по телефону, e-mail или имени/фамилии. Телефон и e-mail ищутся через поиск дублей Битрикс24 (формат номера не важен), имя — по подстроке. Возвращает contacts (id, name, phones, emails, post, company_id, responsible) и deals — открытые сделки найденных контактов. Используйте перед звонком и перед созданием сделки. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Inputs: query (required), limit.

b24_get_dealКарточка сделкиA
Read-onlyIdempotent

Полная карточка одной сделки по id: всё из b24_search_deals плюс comments сделки, contacts (телефоны, e-mail, должность), company, open_tasks (со сроком и флагом overdue) и последние комментарии таймлайна. Используйте перед звонком или письмом клиенту; id берите из b24_search_deals или b24_find_contact. Несуществующий id вернёт ошибку «не найдена». Делает 4–6 запросов. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Inputs: id (required), comments_limit.

b24_pipeline_reportОтчёт по воронкеA
Read-onlyIdempotent

Сводка отдела продаж за период по сделкам, созданным в нём: deals, amount, open/won/lost (количество и сумма), win_rate_pct (выиграно / закрыто), avg_cycle_days (от создания до выигрыша), stages — открытые сделки по стадиям, managers — по каждому менеджеру сделки, выиграно, сумма выигранного и конверсия. Отвечает на «как идут продажи в этом месяце» и «кто из менеджеров лучше закрывает». Без дат — все сделки (до 2000). Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Inputs: date_to, date_from, category_id.

b24_portalПортал: воронки, стадии, сотрудникиA
Read-onlyIdempotent

Справочник портала Битрикс24: users (id, name, email, active), categories — воронки сделок (id, name, is_default) со stages (id вида C1:NEW, name, semantics: open/won/lost). Вызывайте первым в разговоре: id воронок, стадий и сотрудников нужны фильтрам b24_search_deals, b24_tasks, b24_pipeline_report и записи в b24_create_deal / b24_update_deal. Результат кэшируется на 10 минут. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Inputs: no named parameters.

b24_search_dealsПоиск сделокA
Read-onlyIdempotent

Ищет сделки по подстроке в названии и фильтрам: воронка (category_id), стадия (stage_id), ответственный, результат (open/won/lost), период создания. Возвращает count, total_amount и deals (id, title, amount, category, stage, result, responsible, contact_id, даты), свежие изменения первыми. Полная карточка с контактом, задачами и комментариями — b24_get_deal; сводная аналитика — b24_pipeline_report; зависшие сделки — b24_stale_deals. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Inputs: limit, query, result, stage_id, +4 more.

b24_stale_dealsЗависшие сделкиA
Read-onlyIdempotent

Открытые сделки без движения: не менялись больше days дней и/или без открытых задач. Возвращает count, amount_at_risk и deals с reasons («нет изменений N дней», «нет открытых задач»), самые крупные первыми. Отвечает на «что у нас зависло» и «где теряем деньги». Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Inputs: days, limit, category_id, responsible_id.

b24_tasksЗадачи сотрудниковA
Read-onlyIdempotent

Список незакрытых задач: scope=overdue — просроченные, today — со сроком сегодня, open — все открытые. Фильтр по ответственному. Возвращает count, by_responsible (сколько у кого, из них просрочено) и tasks (id, title, responsible, deadline, overdue, crm-привязки вида D_123). Отвечает на «что просрочено у менеджеров» и «какие задачи на сегодня». Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически. Только чтение.

Inputs: limit, scope, responsible_id.

b24_update_dealИзменить сделкуA
Idempotent

Меняет сделку: стадию (перевод по воронке), сумму, ответственного, название или описание. Передавайте только то, что меняется; без полей — ошибка. Для закрытия сделки выберите стадию с semantics won/lost из b24_portal. Повторный вызов с теми же данными ничего не меняет. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.

Inputs: id (required), title, amount, comment, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool has a distinct role: portal reference, deal search/get/create/update, contact lookup, lead creation, comments, task listing/creation/completion, and focused reports. Overlaps between deal-listing tools are explicitly resolved by descriptions pointing to the correct tool for analytics, stale deals, or full card retrieval.

    Naming Consistency4/5

    All tools use a consistent b24_ prefix and snake_case with clear object-action naming. Minor deviations include noun-only names like b24_portal, b24_tasks, b24_pipeline_report, and b24_stale_deals, but they remain predictable and readable.

    Tool Count5/5

    The 13-tool surface is well-scoped for a Bitrix24 CRM/sales assistant. It covers reference data, deal workflows, contact lookup, lead capture, comments, tasks, and reporting without excessive or redundant tools.

    Completeness4/5

    Core CRM and task workflows are covered, including deal CRUD minus deletion, contact lookup, lead creation, comments, and task lifecycle. Minor gaps exist: no standalone contact update/create, no lead update/convert, and no general task update beyond completion.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to interact with Bitrix24 CRM through comprehensive tools for managing contacts, deals, leads, companies, tasks, and users, with advanced filtering, search capabilities, and sales team performance monitoring.
      50
      9 npm
      35
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Exposes Bitrix24 REST API to AI assistants, enabling management of tasks, CRM entities, call recordings (with local transcription), users, workgroups, and Knowledge Base articles.
      43
      9 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to interact with Bitrix24 CRM through standardized MCP tools, including searching and managing contacts, deals, leads, tasks, and replying in chats.
      MIT