MCP for reading Bitrix24 straight from the database
bitrix_mcp
A read-only MCP server that reads Bitrix24 deals, contacts and companies with SELECT queries against the database, bypassing the REST API
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- The bitrix_query tool runs arbitrary SELECT statements, including against unrelated tables
- It gives direct access to the structure and data of the live CRM database
Install
- Works in
- Services
Manual install
pip install -r requirements.txtRun inside the bitrix_mcp folder after creating a venv.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The bitrix_query tool runs arbitrary SELECT statements, including against unrelated tables
- It gives direct access to the structure and data of the live CRM database
This is third-party code. Review the repository files before installing.
What it does
Instead of Bitrix24's usual REST methods, the server sends validated SELECT queries to its MySQL database through a custom query API and a BITRIX_API_KEY. It provides ten tools: connection check, deal list and detail, title search, contact and company lists, stage-by-stage deal statistics, table listing and a specific table's structure, plus a free-form bitrix_query for arbitrary SELECT statements. Every free-text parameter is stripped of quotes, semicolons and comments, and any write statement (INSERT, UPDATE, DELETE, DROP and others) is rejected by the validator. The same repository also holds a separate, similar MCP server for SAP, unrelated to the Russian stack.
Who it is for. For developers who need fast read-only access to Bitrix24 CRM data, bypassing the REST API's limits and restrictions.
Good fit when
- You need a deal query or report that is awkward to build with REST methods
- You need to inspect the structure of non-standard CRM tables and fields
- It matters that the agent can never write anything back
Not a fit when
- You have no direct access to the portal's MySQL database or a custom query API over it
- You need to create or change Bitrix24 records: the server only reads
- You only have a regular webhook, not a separate key for a vetted query API
Example request
Show deals in the NEW stage and calculate statistics across all stagesMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
BITRIX_API_KEYrequired, secret- Access key for the portal's own query API
Limitations
The README is in Uzbek. The server does not use a standard Bitrix24 webhook: it needs your own query API with a BITRIX_API_KEY, which most portals do not have set up. Each query returns at most 500 rows. The read-only restriction is enforced only at the application level; the README does not describe a database-level read-only user.
How to disable. Remove the bitrix_mcp server from your MCP client config and revoke BITRIX_API_KEY on your query API's side.
FAQ
Can the server change Bitrix24 data?
No, the validator only allows SELECT; every write statement is rejected before the query is sent.
Do I need a regular Bitrix24 webhook?
No, you need access to the portal's separate query API and a BITRIX_API_KEY, not a standard incoming webhook.
Discussion
No questions or reviews yet.
Related
All Bitrix24 toolsBitrix24 MCP server with sales analytics
Bitrix24 MCP Server
Bitrix24 MCP server in TypeScript with a broad set of CRM tools plus a dedicated group for monitoring manager activity and performance
Bitrix24 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
A read and write MCP server for the Bitrix24 REST API: CRM, tasks, scrum, calendar, disk, messaging and portal events
An MCP server for Bitrix24 CRM contacts and deals via an inbound webhook: search, lists and deal stage changes
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 with a local CRM cache
bitrix24mcp
A Bitrix24 MCP server that keeps a CRM copy in PostgreSQL or SQLite and answers an agent from cache instead of hitting REST every time
README in short
The Uzbek README describes a read-only MCP server over Bitrix24's sitemanager MySQL database: venv-based install, wiring into Claude Code and Claude Desktop, a table of ten tools and security rules (SELECT only, parameter sanitizing, regex-checked table names, the key read only from an environment variable, all diagnostics to stderr). It includes example request phrasings and a troubleshooting section.