About bitrix24-mcp
bitrix24-mcp makes Bitrix24 CRM and collaboration functions available to AI assistants through an incoming webhook. Its tools cover deals, contacts, tasks, users, files, and messages, without requiring an OAuth application.
Key features
- 01Filter, view, and manage CRM deals
- 02Search and create contacts
- 03Create and complete tasks
- 04Query users with filters
- 05Upload files and send messages
Use cases
- 01Find deals by stage or owner
- 02Create contacts or update deal details
- 03Assign tasks and track completion
- 04Upload files or message employees
MCP support
The MCP server exposes 12 tools to MCP clients through a Bitrix24 incoming webhook, covering deals, contacts, tasks, users, files, and messages.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @theyahia/bitrix24-mcpBITRIX24_WEBHOOK_URLSecretAPI key for the serviceLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
4Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| start | number | No | Offset for pagination (multiples of 50) |
| filter_stage_id | string | No | Filter by stage ID (e.g. NEW, WON, LOSE) |
| filter_assigned_by_id | number | No | Filter by responsible user ID |
Details
From the project READMEБитрикс24 MCP — сделки, задачи и контакты CRM через нейросеть
Если вы искали, как подключить Битрикс24 к ИИ-ассистенту, спрашивать про сделки и задачи обычными словами или заводить карточки не открывая интерфейс — это оно. 12 инструментов для сделок, контактов, задач, пользователей, файлов и сообщений. Подключение — через входящий вебхук Bitrix24, без OAuth-приложения и без программирования.
Часть серии WWmcp от @theYahia.
Настройка
- В Битрикс24 откройте Приложения → Разработчикам → Другое → Входящий вебхук
- Создайте вебхук с правами:
crm,task,user,disk,im - Скопируйте полный URL вебхука
Подключение к 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.