Bitrix24 Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.1Updated Oct 24, 2026

MCP server for Bitrix24 CRM — deals, contacts, tasks via webhook API.

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Lets an assistant read and create Bitrix24 CRM deals, contacts, tasks, users, files and chat messages through an inbound webhook.

What you can do
Connects an AI assistant to a Bitrix24 portal over an inbound webhook and exposes 12 tools. It can list and fetch deals, create and update deals, list and create contacts, list, create and complete tasks, list employees, upload files to Bitrix24.Disk, and send chat messages to an employee or group. Filtering by stage, assignee, name, phone, e-mail, status, department and sorting is supported.
When to use it
Useful when a team already works in Bitrix24 and wants to query or create CRM records, tasks and messages in natural language without opening the interface. It suits sales and task follow-up inside an existing Bitrix24 portal rather than standalone CRM use.
Requirements
Runs locally as an npm package (npx @theyahia/bitrix24-mcp) over stdio, so Node.js is needed. It requires an inbound Bitrix24 webhook URL with crm, task, user, disk and im permissions, supplied in the BITRIX24_WEBHOOK_URL environment variable. Desktop client only; network access to the Bitrix24 portal is required.
Before you install
The BITRIX24_WEBHOOK_URL embeds an authorization key that grants the webhook's permissions, so treat it as a secret and avoid sharing or logging it. The server can create and update deals and contacts, create and complete tasks, upload files and send chat messages, which changes data in the portal. Grant only the scopes actually needed.

Installation

In SourceWeft

  1. Open Bitrix24 Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

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

[npm] [License: MIT]

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

Настройка

  1. В Битрикс24 откройте Приложения → Разработчикам → Другое → Входящий вебхук
  2. Создайте вебхук с правами: crm, task, user, disk, im
  3. Скопируйте полный URL вебхука

Подключение к 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Отправить сообщение в чат сотруднику или в группу

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

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

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

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

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

Source: README.md at commit 593b491

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts