bitrix-mcp
A read and write MCP server for the Bitrix24 REST API: CRM, tasks, scrum, calendar, disk, messaging and portal events
Install
uv sync
uv tool install .Run inside the cloned repository. The second command puts bitrix-mcp on PATH.
This is third-party code. Review the repository files before installing.
What it does
The server gives the agent 99 typed tools for CRM, tasks, scrum, calendar, disk, workgroups, lists, catalog, business processes and telephony. Generic b24_call and b24_batch reach any REST method, and a method catalog built from the official docs tells the agent which method and parameters to use. The author handles known API traps: filters are sent as a JSON body, access errors are not disguised as empty results, and moving a scrum card uses a sequence that actually works. Portal events arrive via pull channel, outgoing webhook or polling and can be forwarded to Telegram. BITRIX_READ_ONLY blocks all writes.
Who it is for. For Bitrix24 teams and integrators who need full agent access to the portal, not just CRM.
Good fit when
- The agent must create and update deals, tasks or calendar events
- You want to manage a sprint scrum board from chat
- You need portal events with important ones forwarded to Telegram
Not a fit when
- Read-only access to leads and deals is enough
- You cannot give an agent a webhook with broad portal permissions
Example request
Show the active sprint board and move task 1532 to the Done columnLimitations
The webhook URL grants everything its owning user can do. The read-only guard for b24_call and b24_batch detects writes by method verb and can misclassify. fetch_all is capped by BITRIX_MAX_PAGES, about 2000 records by default. Receiving outgoing webhooks needs HTTP mode and an address the portal can reach. Requires Python 3.10+ and uv, or the portable build.
How to disable. Run claude mcp remove bitrix24 or delete the bitrix24 block from the client config, then revoke the webhook in your Bitrix24 profile.
MCP
- Transport
- stdio, http
- Authentication
- API key
| Environment variables | |
|---|---|
| BITRIX_WEBHOOK_URL required, secret | Portal inbound webhook like https://portal/rest/<user_id>/<token>/ |
| BITRIX_READ_ONLY | 1 blocks all write methods |
| BITRIX_MAX_PAGES | Page cap for fetch_all, default 40 |
| BITRIX_TELEGRAM_TOKEN secret | Bot token for forwarding events to Telegram |
Security check
- Creates, changes and deletes deals, tasks, files and events in a live portal
- The webhook is a bearer credential for the whole portal
- Starts business processes and sends messages to employees
README in short
The README in English and Russian describes a general Bitrix24 MCP server with stdio and Streamable HTTP transports. A table lists which bugs of an earlier wrapper were fixed and how. It covers installation via uv or a portable archive, webhook setup, auth precedence, connecting Claude Code, Claude Desktop and a shared .mcp.json, and the full tool catalog. Verification scripts, result limits and the security policy are listed separately.
FAQ
Can I block writes?
Yes, BITRIX_READ_ONLY=1 blocks add, update, delete and similar methods while reads keep working.
What if the machine has no Python?
Build the portable archive with build_portable.py: it bundles Python and a launcher that registers the server in Claude Code, Claude Desktop or Cursor.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
E-Commerce Skills
E-Commerce Skills by Nexscope
A large set of text skills for Amazon, Shopify, eBay, Etsy, TikTok Shop and Walmart sellers: pricing, listings, ads and growth
153 cross-border e-commerce skills via the LinkFox API: Amazon, Ozon, TikTok Shop, 1688, keywords, ads and patents
An MCP server for Bitrix24 CRM contacts and deals via an inbound webhook: search, lists and deal stage changes