Bitrix24 MCP Server (io.github.theYahia/bitrix24-mcp)

This MCP server provides access to Bitrix24 CRM data via a webhook API. It focuses on working with deals, contacts, tasks, users, and related items such as files and messages, enabling these entities to be handled through an AI-assistant interface.

🛠️ Key Features

MCP server for Bitrix24 CRM
Deals, contacts, tasks, and users
Supports files and messages
Integration via incoming webhook “Bitrix24”
12 tools for CRM-related operations

🚀 Use Cases

Ask for deals and tasks in natural language
Create or manage CRM cards without opening the Bitrix24 interface
Connect Bitrix24 to an AI assistant for CRM workflows

⚡ Developer Benefits

TypeScript-based package (as listed in topics)
Uses webhook integration rather than OAuth application setup
12 available tools covering common CRM entity interactions

⚠️ Limitations

Described setup is webhook-based; no OAuth application approach is mentioned
Scope is limited to the listed CRM entity types (deals, contacts, tasks, users, files, messages)

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

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

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

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

json

{
  "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

bash

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

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

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

code

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

Переменная

Обяз.

Описание

BITRIX24_WEBHOOK_URL

да

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

Install

Configuration

Environment variables

BITRIX24_WEBHOOK_URLrequiredsecret

API key for the service

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "bitrix24-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/bitrix24-mcp@1.0.1"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<YOUR_BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

io.github.theYahia/bitrix24-mcp