Bitrix24 MCP server on fastmcp
Bitrix24 MCP Server
A Python MCP server for Bitrix24 contacts and deals built on fastmcp and fast-bitrix24, with both tools and MCP resources by URI, installed via uvx
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- The update_deal_stage tool changes a deal's stage with no built-in confirmation
- The webhook acts with the permissions of the user it was created for
Install
Manual install
uvx bitrix24-mcpBefore running, set the BITRIX_WEBHOOK_URL environment variable.
This is third-party code. Review the repository files before installing.
What it does
The server wraps part of the Bitrix24 REST API in seven MCP tools for contacts and deals: get by id, search by name, phone or email, a company-filtered list, a list of active deals, and updating a deal's stage. Alongside the tools, the server also exposes MCP resources by URI such as contact://123, deal://456 and deals://active with the same data in text form, which suits clients that request data as resources rather than by calling a tool. The Bitrix24 client is built on the fast-bitrix24 library, dependencies are wired with wireup, and settings come from pydantic-settings.
Who it is for. For developers who want a small Bitrix24 MCP server example that supports both tools and resources, as a base to extend with their own set of entities.
Good fit when
- Your MCP client can request Bitrix24 data as resources by URI, not just via tool calls
- Contacts and deals are enough, and you plan to add the rest yourself
Not a fit when
- You need tasks, leads, companies or creating new entities: the code only supports updating a deal's stage
- You need a finished integration with no extra work: the project is meant as an extensible base
Example request
Find a contact by phone number and show their active deals in Bitrix24Limitations
The only write operation is updating a deal's stage; there is no create or delete for entities. It needs Python 3.12 and webhook permissions covering at least crm. The Russian README describes structure and setup but not any confirmation step before changing a stage. There is a single author, no stars, and the README reads as a project of modest, personal scale.
How to disable. Stop the server process and remove it from your MCP client configuration.
MCP
- Transport
- stdio
- Authentication
- not required
| Environment variables | |
|---|---|
| BITRIX_WEBHOOK_URL required, secret | The Bitrix24 portal inbound webhook URL with crm permissions |
Security check
- The update_deal_stage tool changes a deal's stage with no built-in confirmation
- The webhook acts with the permissions of the user it was created for
README in short
The Russian README describes an MCP integration server giving LLMs access to Bitrix24 contacts and deals, lists the technologies used (fast-bitrix24, fastmcp, pydantic, structlog, ruff, wireup), gives instructions for setting up the webhook and running via uvx or a test script, and separately documents both tools and resources with URI examples. MIT license.
FAQ
Can it create deals and contacts?
No, the README and tool list only cover reading plus one write action: updating a deal's stage.
How do resources differ from tools here?
Resources like contact://123 return the same information as the tools but as text by URI, for clients that request context rather than call a function.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
Yandex Kit skills for store management
kit-skills
Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex
YouGile MCP by Indalo
YouGile MCP
Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit
Bitrix24 portal MCP server
MCP-сервер портала Битрикс24
Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail