<div align="center">

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 · Русский

</div>

---

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

---

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 rang