Skip to main content
Glama
@theyahia/bitrix24-mcp

@theyahia/bitrix24-mcp

by theYahia

Битрикс24 MCP — сделки, задачи и контакты CRM через нейросеть

Если вы искали, как подключить Битрикс24 к ИИ-ассистенту, спрашивать про сделки и задачи обычными словами или заводить карточки не открывая интерфейс — это оно. 12 инструментов для сделок, контактов, задач, пользователей, файлов и сообщений. Подключение — через входящий вебхук Bitrix24, без OAuth-приложения и без программирования.

npm License: MIT

Часть серии WWmcp от @theYahia.

Настройка

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

  2. Создайте вебхук с правами: crm, task, user, disk, im

  3. Скопируйте полный URL вебхука

Related MCP server: Bitrix24 MCP Server

Подключение к Claude Desktop

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "@theyahia/bitrix24-mcp"],
      "env": {
        "BITRIX24_WEBHOOK_URL": "https://your-company.bitrix24.ru/rest/1/your-webhook-key/"
      }
    }
  }
}

Claude Code

claude mcp add bitrix24 -e BITRIX24_WEBHOOK_URL=https://your.bitrix24.ru/rest/1/key/ -- npx -y @theyahia/bitrix24-mcp

Инструменты (12)

Инструмент

Описание

list_deals

Список сделок CRM с фильтрами по стадии, ответственному и сортировкой

get_deal

Получить одну сделку по ID

create_deal

Создать сделку с названием, суммой, стадией и контактами

update_deal

Обновить поля сделки

list_contacts

Список контактов с фильтрами по имени, телефону и e-mail

create_contact

Создать контакт с именем, телефоном и e-mail

list_tasks

Список задач с фильтрами по статусу, ответственному и группе

create_task

Создать задачу с названием, дедлайном и приоритетом

complete_task

Отметить задачу выполненной

list_users

Список сотрудников с фильтрами по активности и отделу

upload_file

Загрузить файл на Битрикс24.Диск

send_message

Отправить сообщение в чат сотруднику или в группу

Демо-промпты

Покажи все открытые сделки в Битрикс24
Создай сделку «Редизайн сайта» на 500000 рублей
Выведи все контакты с почтой на «@gmail.com»
Поставь задачу «Подготовить презентацию» сотруднику 5, дедлайн завтра
Заверши задачу 123
Кто из сотрудников активен в отделе 2?
Отправь сообщение сотруднику 1: «Встреча через 15 минут»

Переменные окружения

Переменная

Обяз.

Описание

BITRIX24_WEBHOOK_URL

да

Полный URL вебхука Битрикс24 вместе с ключом авторизации

Лицензия

MIT


Часть WWmcp · Telegram: @vhodvai

Available Tools

12 tools
complete_taskA

Mark a Bitrix24 task as completed by task ID.

Inputs: task_id (required).

create_contactB

Create a new CRM contact with name, last name, phone, and email.

Inputs: name (required), last_name (required), email, phone, +2 more.

create_dealA

Create a new CRM deal in Bitrix24 with title, amount, stage, and linked contact/company.

Inputs: title (required), comments, stage_id, company_id, +4 more.

create_taskB

Create a new task in Bitrix24 with title, description, responsible user, and deadline.

Inputs: title (required), responsible_id (required), deadline, group_id, +2 more.

get_dealA

Get a single CRM deal by ID with all fields.

Inputs: deal_id (required).

list_contactsA

List CRM contacts from Bitrix24 with optional filters by name, phone, or email.

Inputs: start, select, filter_name, filter_email, +1 more.

list_dealsA

List CRM deals from Bitrix24 with optional filters by stage, responsible user, and sort order.

Inputs: order, start, select, filter_stage_id, +1 more.

list_tasksB

List tasks from Bitrix24 with optional filters by status, responsible user, and group.

Inputs: start, filter_status, filter_group_id, filter_responsible_id.

list_usersA

List Bitrix24 users with optional filters by active status and department.

Inputs: start, filter_active, filter_department_id.

send_messageA

Send an instant message via Bitrix24 IM to a user or chat.

Inputs: message (required), dialog_id (required).

update_dealB

Update an existing CRM deal fields: title, stage, amount, contacts, etc.

Inputs: deal_id (required), title, comments, stage_id, +4 more.

upload_fileA

Upload a file to Bitrix24 disk folder (base64-encoded content).

Inputs: content (required), filename (required), folder_id (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a clearly distinct resource and action, such as list_deals vs get_deal or create_task vs complete_task. No two tools appear to overlap in purpose.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern, e.g. list_deals, create_deal, update_deal, upload_file, send_message. This makes the API surface predictable.

    Tool Count5/5

    Twelve tools is a reasonable, focused set for a Bitrix24 integration covering deals, contacts, tasks, users, files, and messaging. Each tool earns its place without bloat.

    Completeness3/5

    Core workflows for deals, contacts, and tasks are present, but there are notable gaps: contacts lack update/delete and get-by-id, tasks lack get/update/delete, and deals lack delete. These missing operations could force agents into workarounds.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    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
      7 npm
      35
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables language models to interact with Bitrix24 CRM, providing tools to manage deals, leads, contacts, tasks, activities, users, files, chat messages, and live chat sessions.
      7 npm
      1
      -
    • 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