How do I use mcp-b24?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-b24 Create a lead: Ivan, phone +7 999 123-45-67" 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.

de en es ja ko ru zh

mcp-b24

by kostikpenzin

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

MCP Server for Bitrix24

43 tools · ~870 actions · Bitrix24 REST 1.0 + 3.0 · 95 tests

MCP server for the Bitrix24 platform. Wraps the Bitrix24 REST API (CRM, tasks, chats, files, calendar, HR, smart processes, mail, telephony, workflows, events, open lines, chat bots, document generator, quotes, currency, webforms, tracking, inventory) into 43 tools your AI agent can call directly — and executes real calls on the portal (unlike the official Bitrix24 MCP, which only serves documentation).

Installation · Configuration · Capabilities · Tools · Scenarios · Development · npm package

Languages: English · Русский

Portal & Subscription

This MCP server wraps the Bitrix24 REST API. Bitrix24 is an all-in-one workspace: CRM, tasks, projects, chats, video calls, documents, mail, calendar, HR, business processes, telephony, and more. It is available as cloud (*.bitrix24.ru / *.bitrix24.com) and on-premise.

⚠️ A Bitrix24 portal is required to use this server. You need either an incoming webhook (BX24_WEBHOOK_URL) or an OAuth application (BX24_DOMAIN + BX24_CLIENT_ID + BX24_CLIENT_SECRET + BX24_REFRESH_TOKEN). Create a webhook under Developer resources → Incoming webhook on your portal, or register an OAuth app at oauth.bitrix24.ru.

➡️ More details: bitrix24.com · REST docs: apidocs.bitrix24.ru

Related MCP server: fast-bitrix24-mcp

Compatible API Versions

API	Version	Base Path	Auth	Modules
Bitrix24 REST	1.0 + 3.0	`/rest/<method>.json`	incoming webhook or OAuth 2.0	CRM, tasks, IM, disk, calendar, user, catalog, lists, mail, telephony, bizproc, HR, timeman, events, open lines, chat bots, document generator, quotes, currency, webforms, tracking, inventory

Installation

Prerequisites

Node.js 18+
An active Bitrix24 portal (cloud or on-premise)
An auth credential: incoming webhook or OAuth app (see below)

Install from npm

npm install -g mcp-b24
# or run without installing
npx -y mcp-b24

Environment Variables

Variable	Required	Description
`BX24_MODE`	Optional	`webhook` or `oauth` (auto-detected if omitted)
`BX24_WEBHOOK_URL`	webhook	Incoming webhook URL: `https://portal.bitrix24.ru/rest/<user_id>/<secret>/`
`BX24_DOMAIN`	oauth	Portal domain, e.g. `portal.bitrix24.ru`
`BX24_CLIENT_ID`	oauth	OAuth client id
`BX24_CLIENT_SECRET`	oauth	OAuth client secret
`BX24_REFRESH_TOKEN`	oauth	Refresh token for auto-refresh
`BX24_ACCESS_TOKEN`	Optional	Ready access token (otherwise obtained from refresh)
`BX24_OAUTH_SERVER`	Optional	`https://oauth.bitrix.info` (default)
`BX24_CONFIRM_DESTRUCTIVE`	Optional	Set `true` to require `confirm: true` before destructive actions
`BX24_AUTO_PAGINATE`	Optional	Set `true` to auto-collect list pages up to `BX24_MAX_ROWS`
`BX24_MAX_ROWS`	Optional	Row cap for auto-pagination (default 5000)
`BX24_RATE_LIMIT_RPS`	Optional	Requests/sec (≤2 non-Enterprise, ≤5 Enterprise; default 2)
`BX24_RATE_LIMIT_BURST`	Optional	Token-bucket burst (default 50)
`BX24_DEFAULT_LANG`	Optional	`ru` or `en` (default `ru`)
`BX24_LOG_LEVEL`	Optional	`silent` `error` `warn` `info` `debug` (default `info`)
`BX24_AUDIT_LOG`	Optional	JSONL audit path for destructive + auth events (omit to disable)
`BX24_TRANSPORT`	Optional	`stdio` or `http` (default `stdio`)
`BX24_HTTP_HOST/PORT/PATH`	Optional	HTTP transport endpoint (default `127.0.0.1:3000/mcp`)
`BX24_HTTP_TOKEN`	Optional	If set, the HTTP transport requires `Authorization: Bearer <token>`
`BX24_CORS_ORIGIN`	Optional	CORS for browser-based MCP clients — disabled by default; set `*` or a specific origin like `https://app.example.com` to enable

You can either:

Set BX24_WEBHOOK_URL — simplest, acts on behalf of the webhook creator; no refresh needed, or
Set BX24_DOMAIN + OAuth credentials — the server will auto-refresh access tokens (≈1 h lifetime) and follow client_endpoint from the OAuth response.

Destructive Action Confirmation

When BX24_CONFIRM_DESTRUCTIVE=true is set, the server requires an explicit confirm: true parameter before executing destructive actions (delete, remove, complete, leave, kick, cancel, stop, close, mute, unbind, clear, markDeleted, kill, …). Without it, the tool returns a structured requiresConfirmation preview and does not execute, protecting against accidental data loss with AI agents. Every destructive operation that runs is written to the JSONL audit log (BX24_AUDIT_LOG). When unset or false, destructive actions execute without confirmation (default).

MCP Client Configuration

Claude Desktop

Add to claude_desktop_config.json:

npx (recommended):

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": {
        "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/",
        "BX24_CONFIRM_DESTRUCTIVE": "true"
      }
    }
  }
}

OAuth:

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": {
        "BX24_MODE": "oauth",
        "BX24_DOMAIN": "portal.bitrix24.ru",
        "BX24_CLIENT_ID": "app.abc123",
        "BX24_CLIENT_SECRET": "******",
        "BX24_REFRESH_TOKEN": "******"
      }
    }
  }
}

Windows — use cmd /c:

{
  "mcpServers": {
    "bitrix24": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-b24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

Docker:

docker build -t mcp/bitrix24 .

{
  "mcpServers": {
    "bitrix24": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "BX24_WEBHOOK_URL", "mcp/bitrix24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

Streamable HTTP:

BX24_TRANSPORT=http BX24_HTTP_PORT=3000 BX24_WEBHOOK_URL="https://..." npx mcp-b24
# serves http://127.0.0.1:3000/mcp

The HTTP transport accepts only local/IP-literal Host headers (DNS-rebinding defence), caps request bodies at 2 MB, and is unauthenticated by default — bind it to a public interface only together with BX24_HTTP_TOKEN (clients then send Authorization: Bearer <token>). CORS is disabled unless BX24_CORS_ORIGIN is set (browser-based MCP clients only).

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "bitrix24": {
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

VS Code

Add to .vscode/mcp.json (note: top-level key is servers, not mcpServers):

{
  "servers": {
    "bitrix24": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-b24"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

Codex CLI

codex mcp add bitrix24 --env BX24_WEBHOOK_URL=https://portal.bitrix24.ru/rest/1/abcd1234/ -- npx -y mcp-b24

From source

git clone https://github.com/kostikpenzin/mcp_b24.git
cd mcp_b24
npm install
npm run build

{
  "mcpServers": {
    "bitrix24": {
      "command": "node",
      "args": ["/absolute/path/to/mcp_b24/dist/index.js"],
      "env": { "BX24_WEBHOOK_URL": "https://portal.bitrix24.ru/rest/1/abcd1234/" }
    }
  }
}

Tools Overview

43 tools, ~870 actions

Tool	Description	Group
`bx24_crm_leads`	Leads: CRUD, contacts, product rows, user fields, convert, card config	CRM
`bx24_crm_deals`	Deals + pipelines/categories, product rows, contact bindings, recurring, user fields	CRM
`bx24_crm_contacts`	Contacts: CRUD, company bindings, user fields, card config	CRM
`bx24_crm_companies`	Companies: CRUD, contact bindings, user fields, card config	CRM
`bx24_crm_invoices`	Invoices (SMART_INVOICE, entityTypeId=31) + stages	CRM
`bx24_crm_products`	Trade catalog: products, sections, prices, stores, price types, measures, VAT, ratios, inventory documents, properties, offers/SKU/services	CRM
`bx24_crm_activities`	Activities (calls/meetings/emails) + todo + configurable + types + badges + full timeline	CRM
`bx24_crm_requisites`	Requisites + presets + bank details + links + user fields	CRM
`bx24_crm_duplicates`	Duplicate search & merge + status dictionaries + volatile types	CRM
`bx24_smart_processes`	Smart processes: types + items (arbitrary entities)	CRM
`bx24_crm_quotes`	Quotes: CRUD, product rows, contact bindings, user fields	CRM
`bx24_crm_documents`	Document generator: templates, documents, numerators, bindings, providers	CRM
`bx24_crm_currency`	Currencies: CRUD, base currency, localizations	CRM
`bx24_crm_webform`	Webforms + results + options	CRM
`bx24_crm_tracking`	Tracking: traces, sources, channels	CRM
`bx24_crm_automation`	CRM automation triggers	CRM
`bx24_crm_calllists`	Call lists (cold-call dial lists)	CRM
`bx24_crm_addresses`	CRM addresses: CRUD, by client, delete by filter	CRM
`bx24_crm_stagehistory`	Stage movement history	CRM
`bx24_crm_summary`	CRM overview: total counts of leads/deals/contacts/companies + lead statuses + deal funnels in one call	CRM
`bx24_tasks`	Tasks: lifecycle + checklists + comments + elapsed + flows + stages + planner + dependencies + user fields	collab
`bx24_projects`	Groups/projects (social network) + members + subjects	collab
`bx24_disk`	Disk: storages, folders, files, versions, sharing, external links, rights	collab
`bx24_im`	Messenger: messages, notifications, users, search, counters, recent, departments, events v2, files v2	collab
`bx24_im_chat`	Chats: create, members, owner/manager, title/color/avatar, mute, messages	collab
`bx24_conf`	Video conferences	collab
`bx24_calendar`	Calendar: events, sections, meetings, resources, availability, settings	collab
`bx24_openlines`	IM open lines: configs, sessions, operators, CRM links, network	collab
`bx24_bots`	Chat bots v2: registration, chats, messages, reactions, commands, files, events	collab
`bx24_users`	Users: current, get, search, user fields (incl. list), CRUD	org
`bx24_departments`	Departments / org structure	org
`bx24_time`	Working time tracking (timeman) + time control + network ranges + schedules + records	org
`bx24_hr`	HR: employees, invite, dismiss, transfer	org
`bx24_lists`	Universal lists (infoblocks) + sections + field types	biz
`bx24_mail`	Mail: mailboxes, messages, send/reply/forward, filters, services, message→task/calendar/chat/CRM	biz
`bx24_reports`	Analytics & reports	biz
`bx24_marketing`	Segments, broadcast, lead filters	biz
`bx24_workflows`	Business processes & robots: templates, instances, tasks, robot/activity CRUD, events	biz
`bx24_telephony`	Telephony: external lines/calls, SIP, voximplant (callbacks, info-calls, TTS, lines, stats)	biz
`bx24_events`	Event subscriptions + offline queue + supported events list	biz
`bx24_batch`	Combine up to 50 REST calls in one request (`$result[]` refs)	generic
`bx24_call`	Invoke any Bitrix24 REST method by name (escape-hatch)	generic
`bx24_health`	Verify API connectivity, credentials, and response time	generic

Each domain tool is action-based: the action enum selects the operation (e.g. action: "add", "list", "update", "delete"). Full action list: docs/en/TOOLS_REFERENCE.md (RU: docs/ru/).

Capabilities

The MCP server understands natural language in Russian and English. You don't need to know tool names or action enums — describe what you want in plain language and the AI agent maps it to the right tool and action.

What you can do

CRM — create/find/update leads, contacts, companies, deals, quotes; move deals across pipelines; manage activities (calls/meetings); product rows; custom fields; requisites + bank details; find & merge duplicates; smart processes; document generation; currencies; webforms; tracking; addresses; call lists; automation triggers; stage history
Tasks & projects — create, complete, delegate, defer tasks; checklists; comments; elapsed time; flows; kanban stages; planner; dependencies; user fields; manage groups/projects + subjects
Chats & messenger — create chats, add/remove members, send/edit/delete messages, reactions, search, counters, notifications, recent; open lines (configs, sessions, operators); chat bots v2 (registration, commands, files)
Files (Disk) — upload/download/move/copy files, list folders, versions, sharing, public links, rights, attached objects
Calendar — events, sections, meetings, resources, availability, settings
HR & org — users, departments, working time + time control + network ranges + schedules, invite/dismiss/transfer
Business — universal lists + sections, mail (incl. message→task/event/ chat/CRM), reports, marketing, workflows + robot/activity CRUD, telephony (calls, SIP, voximplant callbacks/info-calls/TTS/lines/stats), events
Trade catalog — products, sections, prices, price types, measures, VAT, ratios, rounding rules, extra charges, inventory documents, product properties, variations (offers), SKU heads, services, stock records (bizproc), telephony, event subscriptions
Batch & generic — combine up to 50 calls; call any REST method by name

Security

Credentials (webhook secret, OAuth tokens) are never exposed to the AI agent or returned in tool results — even bx24_health reports the portal as a host name only
Destructive actions can require explicit confirm: true (BX24_CONFIRM_DESTRUCTIVE=true) and are written to the JSONL audit log; audit entries mask secret-like parameter keys (also nested ones)
The HTTP transport hardening: CORS is opt-in (BX24_CORS_ORIGIN, empty = disabled), Host headers are validated against local names/IP literals (DNS-rebinding defence), request bodies are capped at 2 MB, and an optional shared token (BX24_HTTP_TOKEN) enables Authorization: Bearer checks
Rate limits are respected via a token-bucket; QUERY_LIMIT_EXCEEDED (503) and OPERATION_TIME_LIMIT (429) are retried with backoff
Password management and auth/login actions are excluded — auth is handled automatically via environment variables

Usage Scenarios

1. Create a lead

You say: "Create a lead Ivan Petrov, phone +79001234567, email ivan@example.ru"

The AI agent will call bx24_crm_leads with action: "add" and fields = { TITLE: "Ivan Petrov", PHONE: [{ VALUE: "+79001234567", VALUE_TYPE: "WORK" }], EMAIL: [...] }.

2. Show my tasks for today

You say: "Покажи мои задачи на сегодня"

The AI agent will call bx24_tasks with action: "list" filtering by RESPONSIBLE_ID = current and DEADLINE = today.

3. Move a deal across the pipeline

You say: "Передвинь сделку №456 на стадию «В работе»"

The AI agent will call bx24_crm_deals with action: "update" setting STAGE_ID (stages can be listed via action: "category_list").

4. Send a message to a chat

You say: "Напиши в чат «Проект Альфа»: релиз сегодня в 18:00"

The AI agent will call bx24_im_chat with action: "sendMessage" (DIALOG_ID = chatNNN, MESSAGE = "…").

You say: "Загрузи PDF-договор на Диск в папку «Договоры 2026» и скинь ссылку в чат «Партнёры»"

The AI agent will: bx24_disk → file_upload, then file_getExternalLink, then bx24_im_chat → sendMessage.

6. Start an approval workflow

You say: "Запусти бизнес-процесс «Согласование с юристами» для сделки #456"

The AI agent will call bx24_workflows with action: "start", templateId and documentId = ["crm", "DEAL", 456].

7. Analyze the sales funnel

You say: "Сделай отчёт по воронке «Продажи»: сделки по этапам, средний чек"

The AI agent will call bx24_crm_deals action: "list" (filtered by CATEGORY_ID) and bx24_reports action: "funnel_stages", then aggregate.

Development

npm install          # Install dependencies
npm run build        # Compile TypeScript + chmod +x
npm run dev          # Watch mode
npm test             # Run 95 tests (vitest)
npm run test:coverage
npm start            # Run server
docker build -t mcp/bitrix24 .   # Docker image
npm publish          # Publish to npm (auto clean + build + test)

Project Structure

mcp_b24/
├── src/
│   ├── index.ts          # MCP server entry point (transport selection)
│   ├── server.ts         # MCP server: register/list/call + instructions
│   ├── config.ts         # Environment configuration (BX24_*)
│   ├── api-client.ts     # HTTP client: webhook/OAuth, refresh, backoff, token-bucket
│   ├── error.ts          # Error handling
│   ├── types.ts          # Shared types
│   ├── i18n/             # ru.ts, en.ts, index.ts
│   ├── audit/log.ts      # JSONL audit of destructive + auth events
│   ├── utils/            # logger, tokenBucket
│   ├── transport.ts      # stdio + Streamable HTTP
│   └── tools/
│       ├── framework.ts  # Data-driven action-tool framework
│       ├── params.ts     # Reusable param schemas
│       ├── index.ts      # Tool registration (43 tools)
│       ├── batch.ts      # bx24_batch
│       ├── call.ts       # bx24_call (escape-hatch)
│       ├── health.ts     # bx24_health (API connectivity check)
│       ├── crm/          # 20 CRM tools (incl. summary)
│       ├── collab/       # 9 collab tools
│       ├── org/          # 4 org tools
│       └── biz/          # 7 biz tools
├── docs/                 # en/ + ru/ (USER_GUIDE, SELLER_GUIDE, DEVELOPER_GUIDE, TOOLS_REFERENCE, AUDIT_LOG)
├── i18n/README.ru.md     # Russian README
├── specs/openapi.yaml    # OpenAPI overview
├── Dockerfile            # Multi-stage Docker build
├── docker-compose.yml
├── .env.example
├── LICENSE
├── CHANGELOG.md
├── package.json
└── tsconfig.json

License

MIT

Author

Penzin Konstantin — GitHub · penzin85@gmail.com

Available Tools

43 tools

bx24_batchA

Bitrix24 batch: combine multiple REST calls into one request. Method batch (REST 1.0 + 3.0). Reference earlier results inside later commands with $result[key]. RU/EN: пакет, батч, несколько вызовов, объединить вызовы / batch, combine calls, multiple calls.

Inputs: cmd (required), halt, confirm.

bx24_botsC

Bitrix24 chat bots v2 (чат-боты): bot registration, chats, messages, reactions, commands, files, events. Methods imbot.v2.* (REST 1.0 + 3.0). RU/EN: чат-бот, бот, зарегистрировать бота, команда, реакция / chat bot, register bot, command, reaction.

Inputs: action (required), code, file, botId, +11 more.

bx24_calendarC

Bitrix24 calendar: events, sections, meeting status, resources, accessibility, settings. Methods calendar.event., calendar.section., calendar.meeting., calendar.resource., calendar.accessibility., calendar.user.settings. (REST 1.0 + 3.0). RU/EN: событие, встреча, календарь, создай событие, ближайшие, доступность / event, calendar, create event, nearest, availability.

Inputs: action (required), id, to, from, +13 more.

bx24_callA

Universal Bitrix24 REST call: invoke any REST method by name with arbitrary params. Escape-hatch for methods not covered by dedicated tools (REST 1.0 + 3.0). RU/EN: вызови метод, сделай произвольный вызов, вызови rest-метод / call rest method, invoke method, raw rest call.

Inputs: method (required), params, confirm, httpVerb.

bx24_confC

Bitrix24 video conferences (Zoom-аналог). Methods im.conference.* (REST 1.0 + 3.0). RU/EN: конференция, видеовстреча, собери созвон / conference, video call, schedule call.

Inputs: action (required), id, order, start, +5 more.

bx24_crm_activitiesB

Bitrix24 CRM activities (дела/звонки/встречи/письма): CRUD, complete, todo, configurable, types, badges, timeline (comments/notes/logmessages/bindings). Methods crm.activity., crm.activity.todo., crm.activity.configurable., crm.activity.type., crm.activity.badge., crm.timeline. (REST 1.0 + 3.0). RU/EN: дело, запланируй звонок, запланируй встречу, заверши дело, таймлайн, заметка, лог / activity, plan a call, plan a meeting, complete activity, timeline, note, log.

Inputs: action (required), id, order, start, +8 more.

bx24_crm_addressesB

Bitrix24 CRM addresses (адреса клиентов): CRUD, by client, delete by filter. Methods crm.address.*, crm.address.byclient (REST 1.0 + 3.0). RU/EN: адрес, адрес клиента, фактический адрес, юридический адрес / address, client address, actual address, legal address.

Inputs: action (required), id, order, start, +6 more.

bx24_crm_automationC

Bitrix24 CRM automation triggers (триггеры автоматизации): app triggers, execute, webhook trigger. Methods crm.automation.trigger.* (REST 1.0 + 3.0). RU/EN: автоматизация, триггер, запустить триггер, робот / automation, trigger, execute trigger, robot.

Inputs: action (required), id, code, order, +5 more.

bx24_crm_calllistsB

Bitrix24 CRM call lists (списки обзвона): create, list, get, delete, start, status. Methods crm.calllist.* (REST 1.0 + 3.0). RU/EN: список обзвона, обзвон, прозвон / call list, cold call list, dial list.

Inputs: action (required), id, order, start, +4 more.

bx24_crm_companiesB

Bitrix24 CRM companies: CRUD, contact bindings, user fields. Methods crm.company., crm.company.contact., crm.company.userfield.* (REST 1.0 + 3.0). RU/EN: компания, создать компанию, найти компанию / company, create company, find company.

Inputs: action (required), id, order, start, +9 more.

bx24_crm_contactsB

Bitrix24 CRM contacts: CRUD, company bindings, user fields. Methods crm.contact., crm.contact.company., crm.contact.userfield.* (REST 1.0 + 3.0). RU/EN: контакт, найти контакт, создать контакт / contact, find contact, create contact.

Inputs: action (required), id, order, start, +9 more.

bx24_crm_currencyC

Bitrix24 CRM currencies (валюты): CRUD, base currency, localizations. Methods crm.currency., crm.currency.base., crm.currency.localizations.* (REST 1.0 + 3.0). RU/EN: валюта, курс, базовая валюта, локализация / currency, base currency, localization.

Inputs: action (required), id, order, start, +5 more.

bx24_crm_dealsB

Bitrix24 CRM deals: CRUD, funnels/categories, product rows, contact bindings, timeline. Methods crm.deal., crm.dealcategory., crm.deal.productrows., crm.deal.contact. (REST 1.0 + 3.0). RU/EN: сделка, создать сделку, найди сделки, передвинуть по воронке, закрыть сделку, товарные позиции / deal, create deal, find deals, move stage, close deal, product rows.

Inputs: action (required), id, row, rows, +14 more.

bx24_crm_documentsC

Bitrix24 CRM document generator (генератор документов): templates, documents, numerators, bindings, providers. Methods crm.documentgenerator.* (REST 1.0 + 3.0). RU/EN: документ, шаблон документа, счёт, договор, нумератор / document, document template, invoice, contract, numerator.

Inputs: action (required), id, order, start, +10 more.

bx24_crm_duplicatesC

Bitrix24 CRM duplicate search & merge. Methods crm.duplicate.*, crm.entity.mergeBatch (REST 1.0 + 3.0). RU/EN: дубли, найти дубли, объединить / duplicates, find duplicates, merge.

Inputs: action (required), type, order, start, +11 more.

bx24_crm_invoicesB

Bitrix24 CRM invoices (SMART_INVOICE): CRUD, stages, product rows. Methods crm.item.* (entityTypeId=31), crm.status.* (REST 1.0 + 3.0). RU/EN: счёт, создать счёт, найти счета / invoice, create invoice, find invoices.

Inputs: action (required), id, row, rows, +6 more.

bx24_crm_leadsC

Bitrix24 CRM leads: CRUD, fields, contacts, user fields. Methods crm.lead.* (REST 1.0 + 3.0). RU/EN: лид, новый лид, создать лид, найди лиды, обнови лид, удали лид / lead, create lead, find leads, update lead, delete lead.

Inputs: action (required), id, rows, order, +10 more.

bx24_crm_productsB

Bitrix24 trade catalog: products, sections, prices, stores, product rows, price types, measures, VAT, ratios, rounding rules, extra charges, inventory documents, product properties, variations (offers), SKU heads, services. Methods catalog.* (REST 1.0 + 3.0). RU/EN: каталог, товар, раздел, цена, склад, товарная позиция, вариация, услуга, тип цены, единица измерения, НДС, коэффициент, документ склада, свойство товара / catalog, product, section, price, store, variation, offer, sku, service, price type, measure, VAT, ratio, inventory document, product property.

Inputs: action (required), id, order, start, +20 more.

bx24_crm_quotesB

Bitrix24 CRM quotes (коммерческие предложения): CRUD, product rows, contact bindings, user fields. Methods crm.quote., crm.quote.productrows., crm.quote.contact., crm.quote.userfield. (REST 1.0 + 3.0). RU/EN: коммерческое предложение, КП, создать КП / quote, create quote, proposal.

Inputs: action (required), id, rows, order, +9 more.

bx24_crm_requisitesC

Bitrix24 CRM requisites (реквизиты): CRUD, presets, bank details, links, user fields. Methods crm.requisite., crm.requisite.preset., crm.requisite.bankdetail., crm.requisite.link., crm.requisite.userfield.* (REST 1.0 + 3.0). RU/EN: реквизиты, добавить реквизиты компании, пресет, банковские реквизиты, привязка / requisites, company details, preset, bank details, link.

Inputs: action (required), id, order, start, +9 more.

bx24_crm_stagehistoryC

Bitrix24 CRM stage history (история перемещений по стадиям): list, get, fields. Methods crm.stagehistory.* (REST 1.0 + 3.0). RU/EN: история стадий, движение по воронке, история сделки / stage history, funnel movement, deal history.

Inputs: action (required), id, order, start, +4 more.

bx24_crm_summaryA

Bitrix24 CRM summary: total counts of leads, deals, contacts, companies plus lead statuses and deal categories (funnels) in one call (REST 1.0 + 3.0). RU/EN: сводка CRM, сколько лидов/сделок/контактов/компаний, обзор CRM, статусы лидов, воронки / CRM summary, how many leads/deals/contacts/companies, lead statuses, deal funnels.

Inputs: no named parameters.

bx24_crm_trackingC

Bitrix24 CRM tracking (отслеживание источников): traces, sources, channels. Methods crm.tracking.trace., crm.tracking.source., crm.tracking.channel.* (REST 1.0 + 3.0). RU/EN: отслеживание, источник, трекинг, UTM, канал / tracking, source, UTM, channel, trace.

Inputs: action (required), id, order, start, +5 more.

bx24_crm_webformC

Bitrix24 CRM webforms (веб-формы) & results: form CRUD, results, options. Methods crm.webform., crm.webform.result., crm.webform.option.* (REST 1.0 + 3.0). RU/EN: веб-форма, форма обратной связи, результат, заявка с сайта / webform, feedback form, result, lead form.

Inputs: action (required), id, order, start, +5 more.

bx24_departmentsC

Bitrix24 departments (org structure): CRUD + IM dept info. Methods department., im.department. (REST 1.0 + 3.0). RU/EN: отдел, подразделение, оргструктура, найти отдел / department, org structure, find department.

Inputs: action (required), id, order, start, +4 more.

bx24_diskB

Bitrix24 Disk: storages, folders, files, versions, external links. Methods disk.storage., disk.folder., disk.file., disk.version., disk.rights.* (REST 1.0 + 3.0). RU/EN: файл, папка, диск, загрузить файл, скачать, содержимое папки, версия, публичная ссылка / file, folder, disk, upload, download, version, external link.

Inputs: action (required), id, order, start, +11 more.

bx24_eventsB

Bitrix24 event subscriptions + offline queue. Methods event.bind, event.get, event.unbind, event.offline.* (REST 1.0 + 3.0). RU/EN: события, подписка, webhook события, офлайн-очередь, отписаться / events, bind, subscription, offline queue, unbind.

Inputs: action (required), event, order, start, +5 more.

bx24_healthA

Bitrix24 health check: verify API connectivity, credentials, and measure response time (REST 1.0 + 3.0). RU/EN: проверь подключение, работает ли API, статус соединения, пинг / check connection, is API working, health check, ping.

Inputs: no named parameters.

bx24_hrC

Bitrix24 HR: employees + invitations. Methods humanresources.employee.*, user.add/update (REST 1.0 + 3.0). RU/EN: сотрудник, кадры, пригласить, уволить, перевести, профиль / employee, HR, invite, dismiss, transfer, profile.

Inputs: action (required), id, order, start, +5 more.

bx24_imB

Bitrix24 messenger: messages, notifications, user info, search, counters, recent. Methods im.message., im.notify., im.user., im.search., im.counters., im.recent. (REST 1.0 + 3.0). RU/EN: сообщение, написать, уведомление, поиск сообщений, счётчики, недавние / message, notify, search messages, counters, recent.

Inputs: action (required), ID, TO, IDS, +15 more.

bx24_im_chatC

Bitrix24 chats: create, members, owner, title/color/avatar, mute, messages, counters. Methods im.chat., im.dialog. (REST 1.0 + 3.0). RU/EN: чат, создать чат, участники, переименовать, замуть / chat, create chat, members, rename, mute.

Inputs: action (required), file, COLOR, TITLE, +11 more.

bx24_listsB

Bitrix24 universal lists (infoblocks): lists, fields, elements, sections. Methods lists., lists.element., lists.field., lists.section. (REST 1.0 + 3.0). RU/EN: универсальный список, инфоблок, элемент списка, поле / universal list, list element, field, section.

Inputs: action (required), id, order, start, +10 more.

bx24_mailB

Bitrix24 mail: mailboxes, messages, send, reply, forward, filters, recipient. Methods mail.mailbox., mail.message., mail.recipient., mailservice. (REST 1.0 + 3.0). RU/EN: почта, письмо, отправить письмо, ящик, фильтр / mail, email, send email, mailbox, filter.

Inputs: action (required), id, order, start, +9 more.

bx24_marketingB

Bitrix24 marketing: segments from CRM, broadcast send, lead filtering, trade platforms. Methods crm.lead.list (filters), mail.message.send, sale.tradePlatform.* (REST 1.0 + 3.0). RU/EN: сегмент, рассылка, маркетинг, источник лидов, площадка / segment, broadcast, marketing, lead source, trade platform.

Inputs: action (required), name, order, start, +6 more.

bx24_openlinesC

Bitrix24 IM open lines (открытые линии): configs, sessions, dialogs, operators, CRM links, network. Methods imopenlines.* (REST 1.0 + 3.0). RU/EN: открытая линия, линия поддержки, сессия, оператор, диалог / open line, support line, session, operator, dialog.

Inputs: action (required), id, order, start, +8 more.

bx24_projectsC

Bitrix24 groups/projects (соц. сеть): CRUD, members, owner, features. Methods sonet_group., socialnetwork.group., socialnetwork.project.* (REST 1.0 + 3.0). RU/EN: проект, группа, рабочая группа, создать проект, участники / project, group, create project, members.

Inputs: action (required), id, role, order, +10 more.

bx24_reportsB

Bitrix24 analytics & reports: deal pipeline, lead sources, user activity, task completion, deal conversion, funnel stages. Methods crm.deal.list, crm.status.*, crm.lead.list, tasks.task.list aggregations (REST 1.0 + 3.0). RU/EN: отчёт, аналитика, воронка, конверсия, источник, активность / report, analytics, pipeline, conversion, source, activity.

Inputs: action (required), order, start, filter, +3 more.

bx24_smart_processesA

Bitrix24 smart processes (произвольные CRM-сущности): types + items CRUD. Methods crm.type., crm.item. (REST 1.0 + 3.0). RU/EN: умный процесс, смарт-процесс, произвольная сущность, создать тип, элемент / smart process, custom entity, type, item.

Inputs: action (required), id, order, start, +6 more.

bx24_tasksB

Bitrix24 tasks: full lifecycle, checklists, comments, elapsed, flows, stages, planner. Methods tasks.task., task.checklistitem., task.commentitem., task.elapseditem., tasks.flow.Flow., task.planner., task.dependence.* (REST 1.0 + 3.0). RU/EN: задача, поставить задачу, мои задачи, выполнить, делегировать, отложить, чеклист, комментарий, затраченное время / task, my tasks, complete, delegate, defer, checklist, comment, elapsed.

Inputs: action (required), order, start, fields, +18 more.

bx24_telephonyB

Bitrix24 telephony: external lines, external calls, SIP, voximplant, call follow-up. Methods telephony.externalLine., telephony.externalCall., voximplant., call.followup. (REST 1.0 + 3.0). RU/EN: телефония, внешняя линия, звонок, SIP, воксимплант, перезвон / telephony, external line, call, sip, follow-up.

Inputs: action (required), id, order, start, +4 more.

bx24_timeB

Bitrix24 working time tracking (timeman). Methods timeman., timeman.status. (REST 1.0 + 3.0). RU/EN: учёт рабочего времени, открыть день, закрыть день, пауза, перерыв / working time, open day, close day, pause, break.

Inputs: action (required), order, start, filter, +9 more.

bx24_usersC

Bitrix24 portal users: current, get, search, list by department, user fields, user CRUD. Methods user., user.userfield. (REST 1.0 + 3.0). RU/EN: пользователь, кто я, найти сотрудника, отдел, пригласить / user, who am i, find user, invite.

Inputs: action (required), ID, order, start, +8 more.

bx24_workflowsB

Bitrix24 business processes & robots: templates, instances, tasks, robots, activities. Methods bizproc.workflow., bizproc.workflow.template., bizproc.task., bizproc.robot., bizproc.activity.* (REST 1.0 + 3.0). RU/EN: бизнес-процесс, робот, запустить процесс, шаблон, задача БП,杀ить / workflow, business process, robot, start, template, kill.

Inputs: action (required), id, order, start, +12 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.1/5.0

Scored 2026-09-06 05:35 across 43 tools

Disambiguation3/5

Most tools map to clearly distinct Bitrix24 modules, but several boundaries blur: bx24_users and bx24_hr both cover user creation/updating, bx24_im and bx24_im_chat both expose messaging/counters, and bx24_workflows overlaps with bx24_crm_automation around robots/triggers. The descriptions and method prefixes help, but an agent still needs to read carefully to avoid misselection.

Naming Consistency5/5

All 43 tools follow the same `bx24_<module>` snake_case convention with noun-style module names, making the namespace highly predictable. The only mild oddity is `bx24_call` being a generic REST call alongside telephony calls, but the naming pattern itself is uniform.

Tool Count3/5

43 tools is large and exceeds the comfortable range for a single MCP surface, but the server's scope is the full Bitrix24 ecosystem and each tool maps to a real module rather than a redundant operation. Still, the count is heavy enough that an agent will need deliberate filtering and selection.

Completeness4/5

The set covers CRM entities, tasks, disk, messenger, calendar, telephony, automation, HR, and platform utilities with CRUD/lifecycle operations, and `bx24_call` provides an escape hatch for unspecified REST methods. There are minor gaps such as no dedicated sale/order or standalone CRM status module, but common workflows are not dead-ended.

Maintenance

ActivityStale

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Bitrix MCPA
io.github.bitrix24
MCP server that delivers up-to-date Bitrix24 REST API documentation.
Documentation Access API Testing Developer Tools
53
https://mcp-dev.bitrix24.com/mcp
Bitrix24B
io.github.bitrix24
MCP server enabling AI agents to manage Bitrix24 features via standardized protocol
ERP Systems Project Management Communication
2
https://mcp.bitrix24.com/mcp/
NOVA amoCRM / Kommo
ru.nova-amocrm
Remote MCP for amoCRM and Kommo: leads, contacts, tasks, pipelines, chats, Salesbot. OAuth.
CRM Customer Support
1
https://sp1-nova.ru/api/mcp-server/mcp/
Whatcanido — MCP Server for Service BusinessesA
dev.whatcanido.www
Cross-product MCP server for CRM, LeadKit, ProjectKit, Bookio. 10 action types, MIT open spec.
CRM Project Management
2
https://whatcanido.dev/api/mcp

Related MCP Servers

Bitrix24 MCP Server
CRM Project Management
OneAtDrt
F
license
Not graded
quality
D
maintenance
Provides a REST API and MCP server to interact with Bitrix24 CRM, enabling CRUD operations on entities like deals, leads, contacts, and tasks via natural language.
Updated 2 years ago (2025-03-28 13:49 UTC)
9 npm
13
-
fast-bitrix24-mcp
CRM Research & Data
darkClaw921
F
license
Not graded
quality
D
maintenance
MCP server for interacting with Bitrix24 REST API, enabling CRUD operations on deals, contacts, companies, users, leads, and tasks, plus analytics and risk assessment.
Updated a year ago (2025-12-24 18:55 UTC)
2
-
BitrixMCP
CRM Project Management Calendar Management
john7ross
A
license
B
quality
C
maintenance
Universal MCP server for the Bitrix24 REST API, enabling full read and write access to CRM, tasks, calendar, disk, and more. Supports any MCP client with stdio or Streamable HTTP transport.
Updated 2 months ago (2026-09-10 08:37 UTC)
88
1
MIT
bitrix24-mcp
CRM Communication Calendar Management
RCS-kz
F
license
Not graded
quality
C
maintenance
Production-grade MCP server for Bitrix24 Cloud with 45 tools, safe by default. Connects Claude Desktop to your Bitrix24 tenant for AI-driven CRM, tasks, messaging, and calendar operations.
Updated a month ago (2026-10-03 18:13 UTC)
-

MCP Server for Bitrix24

Portal & Subscription

Compatible API Versions

Installation

Prerequisites

Install from npm

Environment Variables

Destructive Action Confirmation

MCP Client Configuration

Claude Desktop

Cursor

VS Code

Codex CLI

From source

Tools Overview

43 tools, ~870 actions

Capabilities

What you can do

Security

Usage Scenarios

1. Create a lead

2. Show my tasks for today

3. Move a deal across the pipeline

4. Send a message to a chat

5. Upload a file and share the link

6. Start an approval workflow

7. Analyze the sales funnel

Development

Project Structure

License

Author

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Bitrix24 MCP Server

fast-bitrix24-mcp

BitrixMCP

bitrix24-mcp