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

MCP server

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
All reasons and checks
Russian stack

ibrahim-dvp/bitrix-mcp-cloudlfare

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/bitrix24-mcp-server-cloudflare-workers

Detects 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.

Install in Cursor

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.

Install in VS Code

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.

Checked against the repository on Sep 26, 2026, commit d070997.

Text for your agent

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 deploy

Deployment 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 number

Limitations

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
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.

Official

Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent

MCP serverHigh risk483Repository stars
Official

Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex

PluginHigh riskRussian stackNo VPN needed28Repository stars
Editors’ pick

Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit

MCP serverHigh riskRussian stackNo VPN needed

Bitrix24 portal MCP server

MCP-сервер портала Битрикс24

Official

Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail

MCP serverHigh riskRussian stackNo VPN needed
Foxx AIBitrix24 MCP server on Cloudflare Workers

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.