Skip to main content
Glama
bitrix24-mcp-server

bitrix24-mcp-server

by a-shipilo

bitrix24-mcp-server

CI License: MIT

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.*)

Инструмент

Что делает

crm_list

поиск по фильтру с сортировкой и постраничным выводом

crm_get

карточка объекта со всеми заполненными полями, телефонами и e-mail

crm_fields

описание полей, включая пользовательские и варианты списков

crm_stages

воронки и стадии сделок, статусы лидов

crm_find_by_contact_info

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

crm_comments

комментарии из таймлайна

crm_create ✋

создание

crm_update ✋

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

crm_delete ✋

удаление

crm_add_comment ✋

комментарий в таймлайн

Задачи

Инструмент

Что делает

tasks_list, task_get

поиск задач и карточка задачи со списком вложений

task_file_read

содержимое вложения задачи (CSV, TSV, JSON, TXT) или сохранение файла на диск

task_comments

последние комментарии задачи: из чата задачи или из ленты комментариев

task_create ✋, task_update ✋

создание и изменение, включая привязку к CRM

task_complete ✋, task_delete ✋

завершение и удаление

task_add_comment ✋

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

task_checklist, task_checklist_add ✋, task_checklist_complete ✋

чек-листы

users_search, user_current

поиск сотрудников, например чтобы узнать ID ответственного

Проекты и скрам

Инструмент

Что делает

projects_list

поиск проектов, рабочих групп и скрамов

project_board

канбан проекта: стадии и задачи на них

task_move_stage ✋

перенос задачи на другую стадию канбана проекта

scrum_sprints

спринты скрама: активный, запланированные, завершённые

sprint_board

доска спринта: стадии, задачи, story points и эпики

sprint_move_task ✋

перенос задачи на другую стадию спринта

scrum_backlog

бэклог в порядке приоритета со story points и эпиками

Бизнес-процессы

Инструмент

Что делает

bp_templates, bp_template

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

bp_start ✋

запуск бизнес-процесса для сделки, лида, контакта, компании или элемента списка

bp_instances

запущенные процессы, в том числе процессы роботов CRM и зависшие

bp_terminate ✋, bp_kill ✋

остановка процесса; удаление процесса вместе с данными

bp_tasks

задания бизнес-процессов: утверждения, ознакомления, запросы информации

bp_task_complete ✋, bp_task_delegate ✋

решение по заданию, передача задания другому сотруднику

Создавать и менять шаблоны бизнес-процессов через входящий вебхук нельзя: Битрикс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 минут.

IMPORTANT

Когда Claude Desktop спросит разрешение на вызовconfirm_action, не выбирайте «Always allow». Тогда Claude Desktop сам будет спрашивать вас перед каждой записью в Битрикс24, и ни одна запись не пройдёт без вашего клика.

Установка

1. Создайте входящий вебхук в Битрикс24

  1. Откройте Приложения → Разработчикам → Другое → Входящий вебхук.

  2. Выдайте права:

    Право

    Для чего

    CRM (crm)

    лиды, сделки, контакты, компании

    Задачи (task)

    задачи, чек-листы, канбан проектов, спринты и бэклог

    Пользователи (минимальные) (user_brief)

    поиск сотрудников. Чтобы видеть их e-mail, выберите Пользователи (базовые) (user_basic)

    Рабочие группы (sonet_group)

    список проектов и скрамов

    Диск (disk)

    скачивание вложений задач (task_file_read)

    Чат и уведомления (im)

    комментарии задач в новой карточке: они хранятся в чате задачи (task_comments)

    Бизнес-процессы (bizproc)

    шаблоны, запуск и остановка процессов, задания

    Права можно добавить позже: адрес вебхука при этом не меняется.

  3. Скопируйте адрес вида https://<ваш-портал>.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/.

WARNING

Адрес вебхука — это пароль: с ним можно работать с CRM от имени вашего пользователя. Не публикуйте его и не коммитьте в репозитории. Сервер действует с правами пользователя, создавшего вебхук.

2. Подключите сервер в Claude Desktop

Нужен установленный uv (brew install uv на macOS).

  1. Откройте Settings → Developer → Edit Config. Откроется файл claude_desktop_config.json.

  2. Добавьте сервер в 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/"
      }
    }
  }
}
  1. Полностью перезапустите 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

Настройки

Переменная

По умолчанию

Описание

BITRIX24_WEBHOOK_URL

—

адрес входящего вебхука, обязательно

BITRIX24_CONFIRM_MODE

auto

auto — диалог, если клиент его поддерживает, иначе confirmation_id; elicitation — только диалог; token — всегда confirmation_id

BITRIX24_CONFIRM_TASKS

true

false — все операции с задачами и проектами без подтверждения

BITRIX24_AUTO_APPROVE

—

инструменты, которые выполняются без подтверждения, через запятую, например task_add_comment,task_move_stage

Для 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

Лицензия

MIT

Available Tools

31 tools
cancel_actionA
Idempotent

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

Inputs: confirmation_id (required). Returns: object

confirm_actionA
Destructive

Выполнить подготовленную операцию. Вызывайте ТОЛЬКО после того, как пользователь увидел preview и явно согласился выполнить именно эту операцию.

Inputs: confirmation_id (required). Returns: object

crm_add_commentA

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

Inputs: id (required), text (required), entity (required). Returns: object

crm_commentsB
Read-only

Комментарии из таймлайна объекта CRM.

Inputs: id (required), entity (required), start. Returns: object

crm_createA

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

Inputs: entity (required), fields (required). Returns: object

crm_deleteA
Destructive

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

Inputs: id (required), entity (required). Returns: object

crm_fieldsA
Read-only

Описание полей объекта CRM: названия, типы, обязательность, варианты списков, в том числе пользовательские поля (ufCrm...). Используйте перед созданием или изменением.

Inputs: entity (required). Returns: object

crm_find_by_contact_infoB
Read-only

Найти ID лидов, контактов и компаний по телефону или e-mail.

Inputs: type (required), values (required), entity. Returns: object

crm_getA
Read-only

Получить лид, сделку, контакт или компанию по ID со всеми заполненными полями.

Inputs: id (required), entity (required). Returns: object

crm_listA
Read-only

Найти лиды, сделки, контакты или компании по фильтру. Пустые поля в ответе опускаются.

Inputs: entity (required), limit, order, start, +2 more. Returns: object

crm_stagesA
Read-only

Воронки и стадии сделок или статусы лидов (ID стадии нужен для фильтра и изменения stageId).

Inputs: entity, category_id. Returns: result

crm_updateA
Destructive

Изменить поля лида, сделки, контакта или компании (например, перевести сделку на другую стадию). Передавайте только изменяемые поля. Требует подтверждения пользователя.

Inputs: id (required), entity (required), fields (required). Returns: object

project_boardA
Read-only

Канбан проекта: стадии по порядку и задачи на каждой стадии. Для скрама используйте sprint_board.

Inputs: group_id (required), max_tasks, include_completed. Returns: object

projects_listA
Read-only

Найти проекты, рабочие группы и скрамы, доступные пользователю вебхука. Для type=scrum используйте scrum_sprints, sprint_board и scrum_backlog, для остальных — project_board.

Inputs: query, start, include_closed. Returns: object

scrum_backlogB
Read-only

Бэклог скрама в порядке приоритета, со story points и эпиками.

Inputs: group_id (required), max_tasks. Returns: object

scrum_sprintsC
Read-only

Спринты скрама, от новых к старым.

Inputs: group_id (required), status. Returns: result

sprint_boardB
Read-only

Канбан спринта: стадии и задачи на них со story points и эпиками.

Inputs: group_id, max_tasks, sprint_id. Returns: object

sprint_move_taskA
Idempotent

Перенести задачу на другую стадию канбана спринта (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_checklistC
Read-only

Пункты чек-листа задачи.

Inputs: id (required). Returns: result

task_checklist_addA

Добавить пункт в чек-лист задачи. Требует подтверждения пользователя.

Inputs: id (required), title (required). Returns: object

task_checklist_completeA
Destructive

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

Inputs: id (required), item_id (required). Returns: object

task_completeB
Destructive

Завершить задачу. Требует подтверждения пользователя.

Inputs: id (required). Returns: object

task_createA

Создать задачу. Обязательны TITLE и RESPONSIBLE_ID (ID можно найти через users_search). Требует подтверждения пользователя.

Inputs: fields (required). Returns: object

task_deleteA
Destructive

Удалить задачу. Требует подтверждения пользователя.

Inputs: id (required). Returns: object

task_getB
Read-only

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

Inputs: id (required). Returns: object

task_move_stageA
Idempotent

Перенести задачу проекта на другую стадию канбана (ID стадий — в project_board). Для задач скрама используйте sprint_move_task. Требует подтверждения пользователя.

Inputs: id (required), stage_id (required). Returns: object

tasks_listB
Read-only

Найти задачи по фильтру. Поля в ответе в camelCase.

Inputs: limit, order, start, filter, +1 more. Returns: object

task_updateA
Destructive

Изменить задачу. Передавайте только изменяемые поля. Требует подтверждения пользователя.

Inputs: id (required), fields (required). Returns: object

user_currentA
Read-only

Пользователь, от имени которого работает вебхук.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 31 tools

    Disambiguation4/5

    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 Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers