bitrix24-mcp
Connects AI assistants to Bitrix24 CRM through an inbound webhook for sales operations, task management, and analytics.
Browse portal users, deal pipelines, and stages.
Search deals by title, pipeline, stage, responsible, result, and creation period.
Read full deal cards with contacts, company, open tasks, and timeline comments.
Find contacts by phone, email, or name and see their open deals.
List open, overdue, or today’s employee tasks with per-person breakdowns.
Generate pipeline reports with win/loss totals, conversion, average cycle, and manager rankings.
Detect stale open deals with no recent activity and/or no open tasks.
Create and update deals, including attaching new or existing contacts.
Create leads, add timeline comments, create tasks linked to CRM entities, and close tasks with results.
Supports Claude Desktop, Claude Code, Cursor, Windsurf, Docker, and respects Bitrix24 REST rate limits.
bitrix24-mcp — Битрикс24 для ИИ-агентов
MCP-сервер, который подключает Claude, Cursor и других ИИ-ассистентов к Битрикс24: сделки, лиды, контакты, задачи и комментарии в таймлайне — плюс аналитика отдела продаж, которую руководитель обычно собирает руками: отчёт по воронке с конверсией и рейтингом менеджеров, зависшие сделки без движения и без задач, просроченные задачи.
Подключается за минуту через входящий вебхук — без приложения в маркете и без OAuth.
Спросите ассистента:
«Как идут продажи за сентябрь? Кто из менеджеров лучше закрывает?»
«Какие сделки зависли больше недели и на какую сумму?»
«Что просрочено у менеджеров на сегодня?»
«Найди клиента +7 900 123-45-67 и подготовь меня к звонку»
«Создай сделку „Сайт для кафе“ на 90 000 в воронке „Проекты“ с контактом Иван, +7 900…, и поставь Анне задачу перезвонить завтра»
Инструменты
Инструмент | Что делает |
| Сотрудники, воронки сделок и стадии с id и признаком won/lost |
| Поиск сделок по названию, воронке, стадии, ответственному, результату, периоду |
| Карточка сделки: контакты с телефонами, компания, открытые задачи, комментарии таймлайна |
| Поиск контакта по телефону (формат не важен), e-mail или имени + его открытые сделки |
| Открытые, просроченные или сегодняшние задачи с разбивкой по сотрудникам |
| Отчёт по воронке: стадии, выиграно/проиграно, конверсия, средний цикл, рейтинг менеджеров |
| Зависшие сделки: без изменений N дней и без открытых задач, крупные первыми |
| Сделка сразу с новым или существующим контактом |
| Стадия, сумма, ответственный, название, описание |
| Лид (входящая заявка) с телефоном, e-mail и источником |
| Комментарий в таймлайн сделки, лида, контакта или компании |
| Задача сотруднику со сроком и привязкой к сделке/лиду/контакту |
| Закрыть задачу с комментарием-результатом |
✏️ — изменяют данные в портале; ассистент должен показать, что запишет, и получить ваше согласие.
Related MCP server: Bitrix24 MCP Server
Подключение
В Битрикс24: Разработчикам → Другое → Входящий вебхук. Отметьте права CRM (crm), Задачи (task) и Пользователи (user), сохраните.
Скопируйте адрес вебхука вида
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-mcpCursor, 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-mcpReady-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.
Смотрите также
amocrm-kommo-mcp — то же для amoCRM и Kommo
ru-business-mcp — проверка контрагентов, курсы ЦБ, пени, производственный календарь
«Бизнес-справочник РФ» — бесплатное приложение в Битрикс24 Маркете: ru-business-mcp прямо в ИИ-ассистенте портала
ru-docs-mcp — счета с QR-кодом и акты в PDF
rf-marketplaces-mcp — аналитика Wildberries
Лицензия
MIT
Available Tools
13 toolsb24_add_commentКомментарий в таймлайнA
Добавляет комментарий в таймлайн сделки, лида, контакта или компании — итог звонка, договорённости, заметка. Возвращает comment_id. Каждый вызов добавляет новый комментарий. Изменяет данные в Битрикс24: покажите пользователю, что будет записано, и получите согласие. Требует BITRIX24_WEBHOOK_URL (входящий вебхук с правами crm, task, user); лимит 2 запроса/с соблюдается автоматически.
Inputs: text (required), entity_id (required), entity_type.
b24_complete_taskЗакрыть задачуAIdempotent
Отмечает задачу выполненной, при желании с комментарием-результатом. Повторный вызов для уже закрытой задачи не меняет данные. Изменяет данные в Битрикс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Найти контактARead-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Карточка сделкиARead-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Отчёт по воронкеARead-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Портал: воронки, стадии, сотрудникиARead-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Поиск сделокARead-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Зависшие сделкиARead-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Задачи сотрудниковARead-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Изменить сделкуAIdempotent
Меняет сделку: стадию (перевод по воронке), сумму, ответственного, название или описание. Передавайте только то, что меняется; без полей — ошибка. Для закрытия сделки выберите стадию с 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
Scored across 13 tools
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.
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.
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.
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
Operate Obriym CRM from your AI assistant: leads, deals, orders, catalog, stock, marketplaces.
Operate the Plixana CRM from any AI: contacts, deals, quotes, WhatsApp and metrics.
WhatsApp CRM for AI agents: search contacts, read chats, manage the sales pipeline, send messages.
A CRM you talk to: leads, deals and a pipeline board inside ChatGPT, Grok and other MCP clients.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables 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.509 npm35MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI agents to interact with Bitrix24 CRM for managing contacts, deals, tasks, and leads via a comprehensive set of tools. It supports advanced features like sales team monitoring, performance analytics, and automated CRM searching.-
- AlicenseAqualityBmaintenanceExposes Bitrix24 REST API to AI assistants, enabling management of tasks, CRM entities, call recordings (with local transcription), users, workgroups, and Knowledge Base articles.439 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Bitrix24 CRM through standardized MCP tools, including searching and managing contacts, deals, leads, tasks, and replying in chats.MIT