io.github.theYahia/bitrix24-mcp
MCP server for Bitrix24 CRM — deals, contacts, tasks via webhook API.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@theyahia/bitrix24-mcpclaude mcp add bitrix24-mcp -e 'BITRIX24_WEBHOOK_URL=<your bitrix24_webhook_url>' -- npx -y @theyahia/bitrix24-mcp@1.0.1
{
"mcpServers": {
"bitrix24-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/bitrix24-mcp@1.0.1"
],
"env": {
"BITRIX24_WEBHOOK_URL": "<your bitrix24_webhook_url>"
}
}
}
}
Environment variables
BITRIX24_WEBHOOK_URLrequired secret API key for the service
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
Битрикс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
Frequently asked questions
What is io.github.theYahia/bitrix24-mcp?
MCP server for Bitrix24 CRM — deals, contacts, tasks via webhook API.
How do I install io.github.theYahia/bitrix24-mcp?
It runs on your machine. In Claude Code: claude mcp add bitrix24-mcp -e 'BITRIX24_WEBHOOK_URL=<your bitrix24_webhook_url>' -- npx -y @theyahia/bitrix24-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.theYahia/bitrix24-mcp need an API key?
Yes. It expects BITRIX24_WEBHOOK_URL, which you set in its configuration.
Is io.github.theYahia/bitrix24-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.theYahia/bitrix24-mcp?
It is published by theYahia. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.