Bitrix24 MCP Server
b24-mcp
An async FastAPI MCP server for Bitrix24 CRM: deals, leads, contacts, tasks and dictionaries with date filter hints
- 2 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- callBitrixMethod calls any REST method and can change CRM data
- The Bitrix24 webhook grants access to customer data in the portal
A similar tool with a larger community: Bitrix24 MCP Server, 64 ★ on the repository
Install
- Works in
- Services
Manual 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.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- callBitrixMethod calls any REST method and can change CRM data
- The Bitrix24 webhook grants access to customer data in the portal
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 ownerMCP
- Transport
- http, sse, stdio
- Authentication
- API key
Environment variables
BITRIX_BASE_URLrequired- Portal REST endpoint, usually https://portal.bitrix24.ru/rest
BITRIX_TOKENrequired, secret- Inbound webhook key or OAuth access token
SERVER_TIMEZONE- Timezone for date hints, default UTC
Limitations
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.
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.
Discussion
No questions or reviews yet.
Related
All Bitrix24 toolsBitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
A TypeScript MCP server for Bitrix24 CRM: contacts, companies, leads, deals, tasks and sales rep performance reports
An MCP server for Bitrix24 CRM contacts and deals via an inbound webhook: search, lists and deal stage changes
MCP server for Bitrix24 CRM analytics: deals, leads, contacts, tasks, manager activity and deals at risk
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 and write MCP server for the Bitrix24 REST API: CRM, tasks, scrum, calendar, disk, messaging and portal events
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
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.