Bitrix24 REST client for MCP developers

intelbit-bitrix24-client

An async Python library for the Bitrix24 REST API: batch calls, pagination and rate limiting, a shared base for building your own MCP servers

MCP serverRussian stack

svyatoslavmikhailov/intelbit-bitrix24-clientAuthor:Интелбит

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/intelbit-bitrix24-client

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 intelbit-bitrix24-client 'https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/'

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "intelbit-bitrix24-client": {
      "type": "http",
      "url": "https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/"
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

PORTALrequired: Bitrix24 portal URL
USER_IDrequired: User ID in webhook URL
TOKENsecret, required: Token in webhook URL

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": {
    "intelbit-bitrix24-client": {
      "url": "https://<PORTAL value>/rest/<USER_ID value>/<your 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

PORTALrequired: Bitrix24 portal URL
USER_IDrequired: User ID in webhook URL
TOKENsecret, required: Token in webhook URL

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":"intelbit-bitrix24-client","type":"http","url":"https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/"}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "intelbit-bitrix24-client": {
      "type": "http",
      "url": "https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/"
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

PORTALrequired: Bitrix24 portal URL
USER_IDrequired: User ID in webhook URL
TOKENsecret, required: Token in webhook URL

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add intelbit-bitrix24-client --url 'https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/'

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.intelbit-bitrix24-client]
url = "https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/"

If the file already exists, append the block to the end.

Keys and settings

PORTALrequired: Bitrix24 portal URL
USER_IDrequired: User ID in webhook URL
TOKENsecret, required: Token in webhook URL

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

gemini mcp add -s user -t http intelbit-bitrix24-client 'https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/'

Or add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "intelbit-bitrix24-client": {
      "httpUrl": "https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/"
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

PORTALrequired: Bitrix24 portal URL
USER_IDrequired: User ID in webhook URL
TOKENsecret, required: Token in webhook URL

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": {
    "intelbit-bitrix24-client": {
      "serverUrl": "https://<PORTAL value>/rest/<USER_ID value>/<your 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

PORTALrequired: Bitrix24 portal URL
USER_IDrequired: User ID in webhook URL
TOKENsecret, required: Token in webhook URL

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": {
    "intelbit-bitrix24-client": {
      "type": "streamableHttp",
      "url": "https://<PORTAL value>/rest/<USER_ID value>/<your 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

PORTALrequired: Bitrix24 portal URL
USER_IDrequired: User ID in webhook URL
TOKENsecret, required: Token in webhook URL

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": {
    "intelbit-bitrix24-client": {
      "type": "streamable-http",
      "url": "https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/"
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

PORTALrequired: Bitrix24 portal URL
USER_IDrequired: User ID in webhook URL
TOKENsecret, required: Token in webhook URL

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": {
    "intelbit-bitrix24-client": {
      "type": "remote",
      "url": "https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/"
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

PORTALrequired: Bitrix24 portal URL
USER_IDrequired: User ID in webhook URL
TOKENsecret, required: Token in webhook URL

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": {
    "intelbit-bitrix24-client": {
      "url": "https://<PORTAL value>/rest/<USER_ID value>/<your TOKEN>/"
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

PORTALrequired: Bitrix24 portal URL
USER_IDrequired: User ID in webhook URL
TOKENsecret, required: Token in webhook URL

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

Text for your agent

Add intelbit-bitrix24-client to your Python project's dependencies, install with uv sync, and import Bitrix24Client with your inbound webhook URL to call Bitrix24 methods.

Other ways from the author

uv sync --extra dev

Installs project dependencies via uv; the library is imported as intelbit_bitrix24_client.

This is third-party code. Review the repository files before installing.

What it does

This is not a ready MCP server but a plain async Bitrix24 REST API client built on httpx, which its authors (the Intelbit studio) use as the base for two of their own projects: a Bitrix24 MCP server and a River connector. The client provides single method calls that unwrap the {result, total, next} response envelope, streaming pagination via list_all supporting both legacy methods (start/next/total) and newer catalog.* methods wrapped in a result_key, and batching up to 50 commands in one request. Authorization is embedded in the inbound webhook URL, connections are not kept alive between calls, and on a QUERY_LIMIT_EXCEEDED error the client backs off exponentially and retries through a rate limiter. The library excludes Dadata, lead generation or FastAPI wiring; it is just the REST client itself.

Who it is for. For developers writing their own Python MCP server or Bitrix24 integration who do not want to rewrite batching, pagination and rate limiting from scratch.

Good fit when

You are writing your own Python async MCP server or script for Bitrix24
You need ready-made pagination across both legacy and newer catalog.* REST methods
You need a rate-limit-resilient batch client instead of hand-rolled retries

Not a fit when

You need a ready-to-use MCP server with out-of-the-box tools: this is only a client library with no MCP layer
You need lead generation, Dadata or a FastAPI web layer: they are deliberately excluded from this library

Example request

Using this client, write a function that pages through all CRM companies with ID and TITLE fields

Limitations

This is a foundation library, not a standalone agent tool: there is no MCP protocol, no CLI, no SKILL.md, just a Python client class to import into your own code. Dependency management is via uv; no standalone package install is documented. The code was extracted from the Intelbit studio's internal bitrix24-mcp project, and the studio itself holds the rights and the CLA.

How to disable. Remove the intelbit-bitrix24-client dependency from your project.

MCP

Transport: stdio
Authentication: API key

Security check

Enables arbitrary Bitrix24 REST API calls, including write methods, if the calling code invokes them
Call rights equal whatever the inbound webhook passed to the client constructor was granted

README in short

The README describes the library as a shared async Bitrix24 REST API client for two of the Intelbit studio's internal projects, gives install via uv sync, examples of a single call, streaming pagination across legacy and newer methods, and batch calls, explains the contract (auth in the webhook URL, no persistent connections, backoff on rate limits), and an "Origin" section noting the code was extracted from bitrix24-mcp and re-licensed under Apache 2.0 legitimately since Intelbit holds the CLA.

FAQ

Is this a ready MCP server?

No, it is only a REST API client library that its authors build their own MCP server and River connector on top of, separately.

How does the client handle Bitrix24 rate limits?

On a QUERY_LIMIT_EXCEEDED error it backs off exponentially and retries through a built-in rate limiter.

Superpowers

Editors’ pick

A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review

PluginMedium riskNo VPN needed292.5K

Skills for real engineers by Matt Pocock

Skills For Real Engineers

Editors’ pick

Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture

SkillLow risk271.4K

Spec Kit

Editors’ pick

GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation

CLIMedium riskNo VPN needed139.3K

Reference MCP servers

Model Context Protocol servers

Official

Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything

MCP serverMedium risk90.6K

Install

What it does

Good fit when

Not a fit when

Example request

Limitations

MCP

Security check

README in short

FAQ

Related

Superpowers

Skills for real engineers by Matt Pocock

Spec Kit

Reference MCP servers