bitrix24-mcp-server
This server lets Claude work with Bitrix24: CRM, tasks, projects/Scrum, and business processes through a webhook, with approval for all write operations.
CRM: find and view leads, deals, contacts, companies; inspect fields and stages; search by phone/email; read timeline comments; create, update, delete, and add comments.
Tasks & projects: search and view tasks; read task file attachments; manage comments and checklists; create/update/complete/delete tasks; search users; list project kanban boards and move tasks between stages.
Scrum: list sprints, view sprint boards with story points and epics, view prioritized backlog, and move tasks between sprint stages.
Business processes: view templates and running instances; start, terminate, or kill processes; complete and delegate BP tasks (approvals, info requests).
Safe writes: every create/update/delete requires explicit user confirmation (preview + confirm_action), with optional auto-approval for selected routine operations via configuration.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bitrix24-mcp-server What tasks are in the current sprint?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bitrix24-mcp-server
MCP-сервер для работы Claude с CRM, задачами, проектами, скрамом и бизнес-процессами Битрикс24 через входящий вебхук.
Запускается через uvx прямо из GitHub, устанавливать ничего не нужно.
Любое создание, изменение или удаление выполняется только после подтверждения пользователем.
English: an open-source MCP server for Bitrix24 CRM (leads, deals, contacts, companies), tasks,
project kanban boards, Scrum sprints and business processes.
Every write operation requires explicit user approval. Run it with
uvx --from git+https://github.com/a-shipilo/bitrix24-mcp-server bitrix24-mcp-server.
Возможности
CRM — лиды, сделки, контакты, компании (универсальный API crm.item.*)
Инструмент | Что делает |
| поиск по фильтру с сортировкой и постраничным выводом |
| карточка объекта со всеми заполненными полями, телефонами и e-mail |
| описание полей, включая пользовательские и варианты списков |
| воронки и стадии сделок, статусы лидов |
| поиск лидов, контактов и компаний по телефону или e-mail |
| комментарии из таймлайна |
| создание |
| изменение полей, например перевод сделки на другую стадию |
| удаление |
| комментарий в таймлайн |
Задачи
Инструмент | Что делает |
| поиск задач и карточка задачи со списком вложений |
| содержимое вложения задачи (CSV, TSV, JSON, TXT) или сохранение файла на диск |
| последние комментарии задачи: из чата задачи или из ленты комментариев |
| создание и изменение, включая привязку к CRM |
| завершение и удаление |
| комментарий: в чат задачи, а на старых порталах — в ленту комментариев |
| чек-листы |
| поиск сотрудников, например чтобы узнать ID ответственного |
Проекты и скрам
Инструмент | Что делает |
| поиск проектов, рабочих групп и скрамов |
| канбан проекта: стадии и задачи на них |
| перенос задачи на другую стадию канбана проекта |
| спринты скрама: активный, запланированные, завершённые |
| доска спринта: стадии, задачи, story points и эпики |
| перенос задачи на другую стадию спринта |
| бэклог в порядке приоритета со story points и эпиками |
Бизнес-процессы
Инструмент | Что делает |
| шаблоны из дизайнера: для каких документов, параметры запуска, дерево действий |
| запуск бизнес-процесса для сделки, лида, контакта, компании или элемента списка |
| запущенные процессы, в том числе процессы роботов CRM и зависшие |
| остановка процесса; удаление процесса вместе с данными |
| задания бизнес-процессов: утверждения, ознакомления, запросы информации |
| решение по заданию, передача задания другому сотруднику |
Создавать и менять шаблоны бизнес-процессов через входящий вебхук нельзя: Битрикс24 разрешает это только приложениям. Методы бизнес-процессов доступны администратору портала.
✋ — операция выполняется только после подтверждения пользователем.
Related MCP server: bitrix24-mcp-server
Как работает подтверждение
Перед записью сервер показывает, что именно изменится:
Изменение сделки #12 «Поставка оборудования»
Портал: https://example.bitrix24.ru
• stageId: NEW → WON
• opportunity: 150000 → 180000Дальше всё зависит от клиента:
Claude Code и другие клиенты с поддержкой elicitation показывают диалог подтверждения. Операция выполнится, только если нажать «Принять».
Claude Desktop и клиенты без elicitation получают от инструмента не результат, а
confirmation_id. Claude показывает вам описание операции и спрашивает разрешения. Операция выполнится только после вызоваconfirm_actionс этимconfirmation_id. Код подтверждения одноразовый и действует 15 минут.
Когда Claude Desktop спросит разрешение на вызовconfirm_action, не выбирайте «Always allow».
Тогда Claude Desktop сам будет спрашивать вас перед каждой записью в Битрикс24,
и ни одна запись не пройдёт без вашего клика.
Установка
1. Создайте входящий вебхук в Битрикс24
Откройте Приложения → Разработчикам → Другое → Входящий вебхук.
Выдайте права:
Право
Для чего
CRM (
crm)лиды, сделки, контакты, компании
Задачи (
task)задачи, чек-листы, канбан проектов, спринты и бэклог
Пользователи (минимальные) (
user_brief)поиск сотрудников. Чтобы видеть их e-mail, выберите Пользователи (базовые) (
user_basic)Рабочие группы (
sonet_group)список проектов и скрамов
Диск (
disk)скачивание вложений задач (
task_file_read)Чат и уведомления (
im)комментарии задач в новой карточке: они хранятся в чате задачи (
task_comments)Бизнес-процессы (
bizproc)шаблоны, запуск и остановка процессов, задания
Права можно добавить позже: адрес вебхука при этом не меняется.
Скопируйте адрес вида
https://<ваш-портал>.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/.
Адрес вебхука — это пароль: с ним можно работать с CRM от имени вашего пользователя. Не публикуйте его и не коммитьте в репозитории. Сервер действует с правами пользователя, создавшего вебхук.
2. Подключите сервер в Claude Desktop
Нужен установленный uv
(brew install uv на macOS).
Откройте Settings → Developer → Edit Config. Откроется файл
claude_desktop_config.json.Добавьте сервер в
mcpServers:
{
"mcpServers": {
"bitrix24": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/a-shipilo/bitrix24-mcp-server@v0.2.3",
"bitrix24-mcp-server"
],
"env": {
"BITRIX24_WEBHOOK_URL": "https://your-portal.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/"
}
}
}
}Полностью перезапустите Claude Desktop. Сервер
bitrix24появится в Settings → Developer со статусом running, а его инструменты — в меню подключений в чате.
@v0.2.3 фиксирует версию. Чтобы всегда брать последнюю версию из main, уберите @v0.2.3.
Для обновления добавьте в args перед --from флаг --refresh.
Если в логах spawn uvx ENOENT, укажите полный путь к uvx (узнать его: which uvx),
например "command": "/opt/homebrew/bin/uvx".
Claude Code
claude mcp add bitrix24 -e BITRIX24_WEBHOOK_URL=https://your-portal.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/ -- uvx --from git+https://github.com/a-shipilo/bitrix24-mcp-server bitrix24-mcp-serverНастройки
Переменная | По умолчанию | Описание |
| — | адрес входящего вебхука, обязательно |
|
|
|
|
|
|
| — | инструменты, которые выполняются без подтверждения, через запятую, например |
Для CRM подтверждение отключить нельзя: crm_* в BITRIX24_AUTO_APPROVE игнорируются.
Автономные сценарии
В рутине, которая работает без человека, подтверждать запись некому. Разрешите нужные инструменты
через BITRIX24_AUTO_APPROVE. Удобно завести для рутины отдельное подключение: в интерактивной
работе подтверждения останутся.
"bitrix24-routine": {
"command": "uvx",
"args": ["--from", "git+https://github.com/a-shipilo/bitrix24-mcp-server@v0.2.3", "bitrix24-mcp-server"],
"env": {
"BITRIX24_WEBHOOK_URL": "https://your-portal.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/",
"BITRIX24_AUTO_APPROVE": "task_add_comment,task_move_stage,sprint_move_task"
}
}Инструмент без подтверждения сразу возвращает status: done и в поле operation — описание того,
что было сделано. Его удобно сохранять в журнал рутины.
Примеры запросов
«Покажи мои сделки на стадии "Переговоры" дороже 100 000»
«Найди контакт с телефоном +7 999 123-45-67 и покажи его сделки»
«Переведи сделку 1542 в "Успешно" и оставь комментарий "Договор подписан"»
«Создай задачу Анне Смирновой подготовить КП по сделке 1542 до пятницы»
«Какие мои задачи просрочены?»
«Покажи доску текущего спринта в скраме "Мобильное приложение" и сколько story points осталось»
«Что сейчас в работе в проекте "Переезд офиса"? Перенеси задачу 318 в "Готово"»
Разработка
git clone https://github.com/a-shipilo/bitrix24-mcp-server.git
cd bitrix24-mcp-server
uv sync
uv run pytest
uv run ruff check . && uv run ruff format --check .Локальная отладка в MCP Inspector:
npx @modelcontextprotocol/inspector -e BITRIX24_WEBHOOK_URL=https://... uv run bitrix24-mcp-serverЛицензия
Available Tools
31 toolscancel_actionAIdempotent
Отменить подготовленную операцию, если пользователь отказался.
Inputs: confirmation_id (required). Returns: object
confirm_actionADestructive
Выполнить подготовленную операцию. Вызывайте ТОЛЬКО после того, как пользователь увидел preview и явно согласился выполнить именно эту операцию.
Inputs: confirmation_id (required). Returns: object
crm_add_commentA
Добавить комментарий в таймлайн лида, сделки, контакта или компании. Требует подтверждения пользователя.
Inputs: id (required), text (required), entity (required). Returns: object
crm_commentsBRead-only
Комментарии из таймлайна объекта CRM.
Inputs: id (required), entity (required), start. Returns: object
crm_createA
Создать лид, сделку, контакт или компанию. Требует подтверждения пользователя.
Inputs: entity (required), fields (required). Returns: object
crm_deleteADestructive
Удалить лид, сделку, контакт или компанию. Требует подтверждения пользователя.
Inputs: id (required), entity (required). Returns: object
crm_fieldsARead-only
Описание полей объекта CRM: названия, типы, обязательность, варианты списков, в том числе пользовательские поля (ufCrm...). Используйте перед созданием или изменением.
Inputs: entity (required). Returns: object
crm_find_by_contact_infoBRead-only
Найти ID лидов, контактов и компаний по телефону или e-mail.
Inputs: type (required), values (required), entity. Returns: object
crm_getARead-only
Получить лид, сделку, контакт или компанию по ID со всеми заполненными полями.
Inputs: id (required), entity (required). Returns: object
crm_listARead-only
Найти лиды, сделки, контакты или компании по фильтру. Пустые поля в ответе опускаются.
Inputs: entity (required), limit, order, start, +2 more. Returns: object
crm_stagesARead-only
Воронки и стадии сделок или статусы лидов (ID стадии нужен для фильтра и изменения stageId).
Inputs: entity, category_id. Returns: result
crm_updateADestructive
Изменить поля лида, сделки, контакта или компании (например, перевести сделку на другую стадию). Передавайте только изменяемые поля. Требует подтверждения пользователя.
Inputs: id (required), entity (required), fields (required). Returns: object
project_boardARead-only
Канбан проекта: стадии по порядку и задачи на каждой стадии. Для скрама используйте sprint_board.
Inputs: group_id (required), max_tasks, include_completed. Returns: object
projects_listARead-only
Найти проекты, рабочие группы и скрамы, доступные пользователю вебхука. Для type=scrum используйте scrum_sprints, sprint_board и scrum_backlog, для остальных — project_board.
Inputs: query, start, include_closed. Returns: object
scrum_backlogBRead-only
Бэклог скрама в порядке приоритета, со story points и эпиками.
Inputs: group_id (required), max_tasks. Returns: object
scrum_sprintsCRead-only
Спринты скрама, от новых к старым.
Inputs: group_id (required), status. Returns: result
sprint_boardBRead-only
Канбан спринта: стадии и задачи на них со story points и эпиками.
Inputs: group_id, max_tasks, sprint_id. Returns: object
sprint_move_taskAIdempotent
Перенести задачу на другую стадию канбана спринта (ID стадий — в sprint_board). Требует подтверждения пользователя.
Inputs: task_id (required), stage_id (required), sprint_id (required). Returns: object
task_add_commentA
Написать комментарий к задаче (в чат задачи, а на старых порталах — в комментарии). Требует подтверждения пользователя.
Inputs: id (required), text (required). Returns: object
task_checklistCRead-only
Пункты чек-листа задачи.
Inputs: id (required). Returns: result
task_checklist_addA
Добавить пункт в чек-лист задачи. Требует подтверждения пользователя.
Inputs: id (required), title (required). Returns: object
task_checklist_completeADestructive
Отметить пункт чек-листа выполненным. Требует подтверждения пользователя.
Inputs: id (required), item_id (required). Returns: object
task_completeBDestructive
Завершить задачу. Требует подтверждения пользователя.
Inputs: id (required). Returns: object
task_createA
Создать задачу. Обязательны TITLE и RESPONSIBLE_ID (ID можно найти через users_search). Требует подтверждения пользователя.
Inputs: fields (required). Returns: object
task_deleteADestructive
Удалить задачу. Требует подтверждения пользователя.
Inputs: id (required). Returns: object
task_getBRead-only
Получить задачу со всеми заполненными полями, включая описание.
Inputs: id (required). Returns: object
task_move_stageAIdempotent
Перенести задачу проекта на другую стадию канбана (ID стадий — в project_board). Для задач скрама используйте sprint_move_task. Требует подтверждения пользователя.
Inputs: id (required), stage_id (required). Returns: object
tasks_listBRead-only
Найти задачи по фильтру. Поля в ответе в camelCase.
Inputs: limit, order, start, filter, +1 more. Returns: object
task_updateADestructive
Изменить задачу. Передавайте только изменяемые поля. Требует подтверждения пользователя.
Inputs: id (required), fields (required). Returns: object
user_currentARead-only
Пользователь, от имени которого работает вебхук.
Inputs: no named parameters. Returns: object
users_searchARead-only
Найти активных сотрудников портала (например, чтобы узнать ID ответственного).
Inputs: query (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 31 tools
Tools are mostly distinct with clear prefixes per domain (crm, task, scrum, project). However, the many task-related tools (task_update, task_complete, task_move_stage) could be confused, though descriptions and stage references help disambiguate.
Naming follows a consistent domain_prefix_action pattern (crm_, task_, scrum_, etc.), but there are minor deviations like tasks_list (plural) and user_current vs users_search, and mixed use of singular/plural for list endpoints.
With 31 tools, the server exceeds the 25-tool threshold for 'too many'. While the breadth of CRM, tasks, and projects justifies some size, the count feels heavy and could overwhelm agents, especially with many similar task-related tools.
The surface covers CRUD for CRM and tasks, plus project boards, sprints, and user lookup. Minor gaps exist (e.g., no direct task reassignment or project member management), but core workflows are well-supported.
Maintenance
Related MCP Connectors
Operate Obriym CRM from your AI assistant: leads, deals, orders, catalog, stock, marketplaces.
MCP server enabling AI agents to manage Bitrix24 features via standardized protocol
Read, write and run Odoo actions from any AI app, as each user, with approval rules per colleague.
Operate the Plixana CRM from any AI: contacts, deals, quotes, WhatsApp and metrics.
Related MCP Servers
- 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.437 npm1MIT
- AlicenseAqualityBmaintenanceEnables interacting with Bitrix24 CRM via webhook API, offering tools for deals, contacts, tasks, users, files, and messaging.121MIT
- AlicenseCqualityCmaintenanceEnables Claude to connect to a Bitrix24 portal through an incoming webhook and manage CRM records, tasks, disk files, calendar events, chat messages, business processes, and more via natural language.41MIT