Bitrix24 MCP with a chat bot layer
Bitrix24 MCP Server
A Bitrix24 MCP server on PyPI with a ready chat-bot layer: an AI agent replies in portal chats like an employee
- 0 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Replies to employees in the portal's group chats on behalf of the registered bot
- Creates and changes deals, leads and tasks in a live portal
A similar tool with a larger community: Bitrix24 MCP Server, 65 ★ on the repository
Install
- Works in
- Services
Manual install
pip install bitrix24-mcpAfter installing, set BITRIX_WEBHOOK_URL and run bitrix24-mcp.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Replies to employees in the portal's group chats on behalf of the registered bot
- Creates and changes deals, leads and tasks in a live portal
This is third-party code. Review the repository files before installing.
What it does
The server provides standard CRM tools (contact search and lookup, deals with filters and stage changes, leads, creating deals and leads) and tasks (search, create, lookup by ID), plus URI resources like contact://123 and deals://active. Its main feature is a ready ChatBotService layer for Bitrix24 chat bots (imbot): a developer only needs to write one handle_message method that calls their own LLM and returns a reply, and the server handles registering the bot in the portal, receiving incoming messages via an HTTP webhook handler, and mirroring replies into a deal's timeline. Once registered, the agent shows up in the portal's group chats like a regular employee and replies to managers directly.
Who it is for. For teams who want to put an AI agent right into Bitrix24 work chats, not just give it access to CRM data.
Good fit when
- You want an AI agent that replies to employees right in Bitrix24 chats
- You need basic CRM work (contacts, deals, leads) and tasks through MCP
- You want bot replies automatically mirrored into a deal's timeline
Not a fit when
- You are not ready to run a public HTTPS endpoint for chat-bot webhooks
- You only need CRM data without embedding an agent into employee chats
Example request
Register the agent bot in Bitrix24 chats and mirror its replies into deal 123's timelineMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
BITRIX_WEBHOOK_URLrequired, secret- The full Bitrix24 inbound webhook URL with crm, imbot, user scopes
BOT_EVENT_HANDLER_URL- The public HTTPS address for receiving chat-bot events
Limitations
The chat-bot feature needs a public HTTPS URL (ngrok, cloudflared or your own hosting) to receive Bitrix24 events; without it only the regular MCP tools work. The AI agent's own logic (calling an LLM) must be written by the developer; the server only provides the registration and message-delivery wiring.
How to disable. Uninstall with pip uninstall bitrix24-mcp, revoke the webhook in the portal, and remove the bot from chats via the connections section or ChatBotService.
FAQ
Do I need to write my own LLM integration?
Yes, the server only provides the wiring (bot registration, receiving messages, replying); calling a specific model is written in one handle_message method.
Can it be used without the chat bot, just for CRM?
Yes, the regular CRM and task tools work over stdio right after the webhook is set up; a public URL is only needed for the chat bot.
Discussion
No questions or reviews yet.
Related
All Bitrix24 toolsBitrix24 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
An MCP server for Bitrix24 CRM contacts and deals via an inbound webhook: search, lists and deal stage changes
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
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
A TypeScript MCP server for Bitrix24 CRM: contacts, companies, leads, deals, tasks and sales rep performance reports
A compact Bitrix24 MCP server on an inbound webhook: tasks, groups, kanban stages and task comments
A read and write MCP server for the Bitrix24 REST API: CRM, tasks, scrum, calendar, disk, messaging and portal events
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Bitrix24 MCP with a chat bot layer (this card) | no | API key | 0 | |
| Bitrix24 MCP by Bit2Beat | no | API key | 6 | CRM, tasks, drive |
| Bitrix24 MCP Server on an OAuth app | no | OAuth | 1 | knowledge base |
| Bitrix24 MCP server with call transcription | no | API key | 1 | tasks, CRM and call transcripts |
README in short
The README describes installing via pip, setting up an inbound webhook with crm, imbot, user scopes, running the server over stdio, example code for registering a custom AI agent in ChatBotService, tool tables for CRM, the chat bot and tasks, URI resources, configs for Claude Desktop, Hermes Agent and Cursor, an architecture diagram, and a full chat-bot example with an HTTP webhook handler. MIT license.