bitrix-mcp
A read and write MCP server for the Bitrix24 REST API: CRM, tasks, scrum, calendar, disk, messaging and portal events
- 1 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- 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
Install
- Works in
- Services
Manual install
uv sync
uv tool install .Run inside the cloned repository. The second command puts bitrix-mcp on PATH.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- 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
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 columnMCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
BITRIX_WEBHOOK_URLrequired, 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_TOKENsecret- Bot token for forwarding events to Telegram
Limitations
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.
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.
How is bitrix-mcp by john7ross different from other Bitrix24 MCP servers?
The server gives the agent 99 typed tools for CRM, tasks, scrum, calendar, disk, groups, lists, catalog, business processes and telephony. The universal b24_call and b24_batch call any REST API method.
Can I forbid the agent to write and what if I have no Python?
Give the Bitrix24 webhook read-only rights and writes become impossible on the portal side. The server installs with uv sync and uv tool install ., and uv can fetch an interpreter by itself. It works in Claude Code, Claude Desktop, Cursor, Windsurf and Cline.
Discussion
No questions or reviews yet.
Related
All Bitrix24 toolsBitrix24 MCP server with real calls
MCP Server for Bitrix24
A Bitrix24 MCP server with 43 tools and about 870 actions that executes real REST API calls instead of just serving documentation
Bitrix24 MCP by Bit2Beat
Bitrix24 MCP Server
Bitrix24 MCP server over an inbound webhook: CRM, tasks, disk, calendar, chat, business processes and config migration between portals
A read-only MCP server that reads Bitrix24 deals, contacts and companies with SELECT queries against the database, bypassing the REST API
Bitrix24 MCP server: tasks, CRM and lists
Bitrix24 Tasks, CRM & Lists MCP Server
A modular Bitrix24 MCP server with 46 tools for tasks and kanban, CRM deals and contacts, and universal lists, running in Docker with no third-party cache
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
A TypeScript MCP server for Bitrix24 CRM: contacts, companies, leads, deals, tasks and sales rep performance reports
Bitrix24 MCP Server (qwito)
Bitrix24 MCP Server
A TypeScript MCP server with 45-plus tools for Bitrix24 CRM: contacts, deals, leads, companies, tasks and activity analytics
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| bitrix-mcp (this entry) | no | API key | 1 | |
| Bitrix24 MCP Server | no | API key | 64 | webhook |
| Bitrix24 MCP Server (gunnit) | no | API key | 34 | in TypeScript for CRM |
| Bitrix24 REST API documentation MCP | yes | not required | 7 | REST API docs |
Alternatives
Tools by other authors for the same tasks.
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.