Bitrix24 MCP Server
b24-mcp
An async FastAPI MCP server for Bitrix24 CRM: deals, leads, contacts, tasks and dictionaries with date filter hints
Install
cp .env.example .env
python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
uvicorn mcp_server.app.main:app --reloadRun inside the cloned repository and set BITRIX_BASE_URL and BITRIX_TOKEN in .env.
This is third-party code. Review the repository files before installing.
What it does
The server translates MCP calls into Bitrix24 REST API requests using an inbound webhook or OAuth token. Tools return deals, leads, contacts, users, tasks and companies, and records are enriched with readable stage, source and owner names from cached dictionaries. When the agent omits a date range, the server adds a warning and a ready filter so it does not dump the whole CRM. getLeadCalls builds a call log for a lead, and callBitrixMethod proxies any REST method. A stdio proxy connects Claude Desktop to the HTTP server.
Who it is for. For sales teams and developers who want to ask an agent about leads and deals in their Bitrix24 portal.
Good fit when
- You need recent leads or deals for a period with readable stage names
- You need the call history for a specific lead
- You want a self-hosted MCP server in Docker for your CRM
Not a fit when
- You need a broad set of typed write tools for CRM, tasks and disk
- You cannot keep a separate HTTP server running
Example request
Show in-progress leads from the last week grouped by ownerLimitations
The server uses its own HTTP endpoints, SSE and WebSocket, and Claude Desktop connects through a proxy script, so the server must run separately. Typed tools only read, but callBitrixMethod calls any method and can change data. The webhook exposes everything its scopes allow. The last repository changes were in November 2025.
How to disable. Remove the b24-mcp block from the Claude Desktop config, stop uvicorn or the container and revoke the webhook in Bitrix24.
MCP
- Transport
- http, sse, stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| BITRIX_BASE_URL required | Portal REST endpoint, usually https://portal.bitrix24.ru/rest |
| BITRIX_TOKEN required, secret | Inbound webhook key or OAuth access token |
| SERVER_TIMEZONE | Timezone for date hints, default UTC |
Security check
- callBitrixMethod calls any REST method and can change CRM data
- The Bitrix24 webhook grants access to customer data in the portal
README in short
The README in English and Russian describes a FastAPI MCP server for Bitrix24 with resources, tools and Russian prompts for the agent. It covers the CallToolResult response format, _meta enrichment, pagination and stage semantics filtering. Setup: a .env with portal URL and token, pip install, run via uvicorn or Docker, and connect Claude Desktop through a stdio proxy. Token requirements, debugging, SSE and WebSocket are documented separately.
FAQ
Which token do I need?
An inbound webhook key with CRM and task access, or an OAuth token with crm, task and user directory scopes.
Will the agent dump the whole CRM at once?
Without filters resources return at most five records, and tools suggest a last-week date range.
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