@theyahia/bitrix24-mcp
This server lets an AI assistant interact with Bitrix24 CRM and collaboration tools through 12 MCP tools.
Deals: list deals with filters by stage/responsible/sort, get deal details, create deals with title/amount/stage/contacts, and update deal fields.
Contacts: list contacts filtered by name, phone, or email, and create contacts with name, phone, email, and linked company.
Tasks: list tasks by status/responsible/group, create tasks with title/description/deadline/priority, and mark tasks as completed.
Users: list employees with optional filters by active status and department.
Files: upload base64-encoded files to a specified Bitrix24 disk folder.
Messaging: send instant messages via Bitrix24 IM to a user or chat using BB-code.
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., "@@theyahia/bitrix24-mcp List all contacts with email containing '@gmail.com'"
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.
Битрикс24 MCP — сделки, задачи и контакты CRM через нейросеть
Если вы искали, как подключить Битрикс24 к ИИ-ассистенту, спрашивать про сделки и задачи обычными словами или заводить карточки не открывая интерфейс — это оно. 12 инструментов для сделок, контактов, задач, пользователей, файлов и сообщений. Подключение — через входящий вебхук Bitrix24, без OAuth-приложения и без программирования.
Часть серии WWmcp от @theYahia.
Настройка
В Битрикс24 откройте Приложения → Разработчикам → Другое → Входящий вебхук
Создайте вебхук с правами:
crm,task,user,disk,imСкопируйте полный 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)
Инструмент | Описание |
| Список сделок CRM с фильтрами по стадии, ответственному и сортировкой |
| Получить одну сделку по ID |
| Создать сделку с названием, суммой, стадией и контактами |
| Обновить поля сделки |
| Список контактов с фильтрами по имени, телефону и e-mail |
| Создать контакт с именем, телефоном и e-mail |
| Список задач с фильтрами по статусу, ответственному и группе |
| Создать задачу с названием, дедлайном и приоритетом |
| Отметить задачу выполненной |
| Список сотрудников с фильтрами по активности и отделу |
| Загрузить файл на Битрикс24.Диск |
| Отправить сообщение в чат сотруднику или в группу |
Демо-промпты
Покажи все открытые сделки в Битрикс24
Создай сделку «Редизайн сайта» на 500000 рублей
Выведи все контакты с почтой на «@gmail.com»
Поставь задачу «Подготовить презентацию» сотруднику 5, дедлайн завтра
Заверши задачу 123
Кто из сотрудников активен в отделе 2?
Отправь сообщение сотруднику 1: «Встреча через 15 минут»Переменные окружения
Переменная | Обяз. | Описание |
| да | Полный URL вебхука Битрикс24 вместе с ключом авторизации |
Лицензия
MIT
Available Tools
12 toolscomplete_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
Scored across 12 tools
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.
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.
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.
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
Related MCP Connectors
Operate Obriym CRM from your AI assistant: leads, deals, orders, catalog, stock, marketplaces.
Read deals, persons, organizations, activities and pipelines; create and update CRM records.
CRM1List leads, contacts, companies and tasks; create and update leads in Kommo.
Operate the Plixana CRM from any AI: contacts, deals, quotes, WhatsApp and metrics.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables 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.507 npm35MIT
- 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.-
- FlicenseNot gradedqualityDmaintenanceEnables 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 npm1-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Bitrix24 CRM through standardized MCP tools, including searching and managing contacts, deals, leads, tasks, and replying in chats.MIT