Bitrix24 MCP server on Cloudflare Workers
Bitrix24 MCP Server - Cloudflare Workers
A lightweight Bitrix24 company management server on Cloudflare Workers with Hono: list, search, get, create, update and delete via a REST API
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 create, update and delete company tools run with no confirmation step
- The webhook token is stored as a Cloudflare Workers secret and grants its creator's permissions
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/bitrix24-mcp-server-cloudflare-workersDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Assembled automatically, review before installing.
Run in a terminal
claude mcp add --transport http bitrix24-mcp-cloudflare 'https://<BITRIX_WORKER_HOST value>' --header 'Authorization: Bearer <your BITRIX_TOKEN>'Or add to the file .mcp.json, in the project
{
"mcpServers": {
"bitrix24-mcp-cloudflare": {
"type": "http",
"url": "https://<BITRIX_WORKER_HOST value>",
"headers": {
"Authorization": "Bearer <your BITRIX_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_BASE_URLsecret, required- Base URL of Bitrix24 REST API
BITRIX_TOKENsecret, required- Bitrix24 webhook token
BITRIX_WORKER_HOSTrequired- Host URL of deployed Cloudflare Worker
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Add to the file ~/.cursor/mcp.json, for all projects
{
"mcpServers": {
"bitrix24-mcp-cloudflare": {
"url": "https://<BITRIX_WORKER_HOST value>",
"headers": {
"Authorization": "Bearer <your BITRIX_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.
Keys and settings
BITRIX_BASE_URLsecret, required- Base URL of Bitrix24 REST API
BITRIX_TOKENsecret, required- Bitrix24 webhook token
BITRIX_WORKER_HOSTrequired- Host URL of deployed Cloudflare Worker
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
The button opens the agent and offers to add the server. If nothing happens, copy the config below.
Run in a terminal
code --add-mcp '{"name":"bitrix24-mcp-cloudflare","type":"http","url":"https://<BITRIX_WORKER_HOST value>","headers":{"Authorization":"Bearer <your BITRIX_TOKEN>"}}'Or add to the file .vscode/mcp.json, in the project
{
"servers": {
"bitrix24-mcp-cloudflare": {
"type": "http",
"url": "https://<BITRIX_WORKER_HOST value>",
"headers": {
"Authorization": "Bearer <your BITRIX_TOKEN>"
}
}
}
}If the file already exists, add the server inside the servers key.
Keys and settings
BITRIX_BASE_URLsecret, required- Base URL of Bitrix24 REST API
BITRIX_TOKENsecret, required- Bitrix24 webhook token
BITRIX_WORKER_HOSTrequired- Host URL of deployed Cloudflare Worker
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file ~/.codex/config.toml, for all projects
[mcp_servers.bitrix24-mcp-cloudflare]
url = "https://<BITRIX_WORKER_HOST value>"
http_headers = { Authorization = "Bearer <your BITRIX_TOKEN>" }If the file already exists, append the block to the end.
Keys and settings
BITRIX_BASE_URLsecret, required- Base URL of Bitrix24 REST API
BITRIX_TOKENsecret, required- Bitrix24 webhook token
BITRIX_WORKER_HOSTrequired- Host URL of deployed Cloudflare Worker
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file ~/.gemini/settings.json, for all projects
{
"mcpServers": {
"bitrix24-mcp-cloudflare": {
"httpUrl": "https://<BITRIX_WORKER_HOST value>",
"headers": {
"Authorization": "Bearer <your BITRIX_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_BASE_URLsecret, required- Base URL of Bitrix24 REST API
BITRIX_TOKENsecret, required- Bitrix24 webhook token
BITRIX_WORKER_HOSTrequired- Host URL of deployed Cloudflare Worker
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file ~/.config/devin/mcp_config.json, for all projects
{
"mcpServers": {
"bitrix24-mcp-cloudflare": {
"serverUrl": "https://<BITRIX_WORKER_HOST value>",
"headers": {
"Authorization": "Bearer <your BITRIX_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.
Keys and settings
BITRIX_BASE_URLsecret, required- Base URL of Bitrix24 REST API
BITRIX_TOKENsecret, required- Bitrix24 webhook token
BITRIX_WORKER_HOSTrequired- Host URL of deployed Cloudflare Worker
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Formerly Windsurf.
Add to the file cline_mcp_settings.json, for all projects
{
"mcpServers": {
"bitrix24-mcp-cloudflare": {
"type": "streamableHttp",
"url": "https://<BITRIX_WORKER_HOST value>",
"headers": {
"Authorization": "Bearer <your BITRIX_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.
Keys and settings
BITRIX_BASE_URLsecret, required- Base URL of Bitrix24 REST API
BITRIX_TOKENsecret, required- Bitrix24 webhook token
BITRIX_WORKER_HOSTrequired- Host URL of deployed Cloudflare Worker
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file .roo/mcp.json, in the project
{
"mcpServers": {
"bitrix24-mcp-cloudflare": {
"type": "streamable-http",
"url": "https://<BITRIX_WORKER_HOST value>",
"headers": {
"Authorization": "Bearer <your BITRIX_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_BASE_URLsecret, required- Base URL of Bitrix24 REST API
BITRIX_TOKENsecret, required- Bitrix24 webhook token
BITRIX_WORKER_HOSTrequired- Host URL of deployed Cloudflare Worker
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
A fork of Roo Code, same .roo folders.
Add to the file opencode.json, in the project
{
"mcp": {
"bitrix24-mcp-cloudflare": {
"type": "remote",
"url": "https://<BITRIX_WORKER_HOST value>",
"headers": {
"Authorization": "Bearer <your BITRIX_TOKEN>"
}
}
}
}If the file already exists, add the server inside the mcp key.
Keys and settings
BITRIX_BASE_URLsecret, required- Base URL of Bitrix24 REST API
BITRIX_TOKENsecret, required- Bitrix24 webhook token
BITRIX_WORKER_HOSTrequired- Host URL of deployed Cloudflare Worker
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Add to the file ~/.config/zed/settings.json, for all projects
{
"context_servers": {
"bitrix24-mcp-cloudflare": {
"url": "https://<BITRIX_WORKER_HOST value>",
"headers": {
"Authorization": "Bearer <your BITRIX_TOKEN>"
}
}
}
}If the file already exists, add the server inside the context_servers key.
Keys and settings
BITRIX_BASE_URLsecret, required- Base URL of Bitrix24 REST API
BITRIX_TOKENsecret, required- Bitrix24 webhook token
BITRIX_WORKER_HOSTrequired- Host URL of deployed Cloudflare Worker
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Deploy the worker with wrangler deploy after setting the BITRIX_BASE_URL and BITRIX_TOKEN secrets via wrangler secret put, then call its REST endpoints such as POST /mcp/tools/bitrix_company_search with a request body, rather than connecting it as a standard MCP server.
Other ways from the author
npm install && wrangler secret put BITRIX_BASE_URL && wrangler secret put BITRIX_TOKEN && npm run deployDeployment to Cloudflare Workers: BITRIX_BASE_URL is the webhook address without the token, BITRIX_TOKEN is its secret part.
This is third-party code. Review the repository files before installing.
What it does
The project deploys as a Cloudflare Worker on the Hono framework and offers six Bitrix24 company operations: a paginated list, a card by id, search by name, create, update and delete. Every request goes to the portal's inbound webhook. The project calls itself MCP but does not implement the MCP JSON-RPC protocol; instead it exposes a custom REST API with endpoints like /mcp/tools and /mcp/tools/:toolName that need to be called directly or described to an agent by instruction. The README's Claude Desktop config example points to a /mcp path that does not exist in the code, so connecting to it as a standard MCP server will not work.
Who it is for. For people who want a serverless REST endpoint for managing Bitrix24 companies on the Cloudflare Workers free tier and are ready to wire it up manually rather than as a standard MCP server.
Good fit when
- You want a serverless REST endpoint for CRUD operations on Bitrix24 companies
- You are fine working through the project's own REST format rather than the standard MCP protocol
Not a fit when
- You need a direct connection as a standard MCP server over JSON-RPC: the protocol is not implemented
- You need to work with contacts, leads or deals: the server only supports companies
Example request
Find the Acme company in Bitrix24 through the worker's REST endpoint and update its phone numberLimitations
Despite the name, the server does not speak the MCP JSON-RPC protocol; it exposes its own REST API with MCP-like path names. The Claude Desktop config shown in the README points to a nonexistent /mcp path and will not work. Only companies are supported, not contacts, leads or deals. Authorization for calls to the worker itself is not described and access needs to be restricted at the Cloudflare level. There is a single author and no stars.
How to disable. Delete the worker from your Cloudflare account with wrangler delete or through the Cloudflare dashboard.
MCP
- Transport
- http
- Authentication
- not required
| Environment variables | |
|---|---|
| BITRIX_BASE_URL required, secret | The base URL of the inbound webhook without the token, e.g. https://portal.bitrix24.com/rest/12345 |
| BITRIX_TOKEN required, secret | The secret webhook token from its URL |
Security check
- The create, update and delete company tools run with no confirmation step
- The webhook token is stored as a Cloudflare Workers secret and grants its creator's permissions
README in short
The README describes deployment on Cloudflare Workers in detail: installing Wrangler, running locally, setting the BITRIX_BASE_URL and BITRIX_TOKEN secrets, a table of six company tools and curl examples for each. It also covers Open WebUI and Claude Desktop integration, though the Claude Desktop example's path does not match the implemented endpoints.
FAQ
Will it connect as a regular MCP server in Claude Desktop?
The README example suggests so, but the code has no /mcp endpoint or JSON-RPC handler, so a direct connection following that instruction will not work.
Which Bitrix24 entities are supported?
Only companies: list, get, search, create, update, delete.
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