bitrix24-mcp

A compact MCP server for Bitrix24: users, tasks, messages and CRM items through one webhook, launched with uvx

MCP server

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • Tools create and delete CRM items and tasks
  • bitrix_call allows calling any API method, not just read-safe ones
All reasons and checks
Russian stack

averagedigital/bitrix_mcp

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/averagedigital-bitrix-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

This entry is high risk, so there is no one-click install. Review the code and add the config by hand.

Run in a terminal

claude mcp add --transport stdio --env 'BITRIX24_WEBHOOK_URL=<your BITRIX24_WEBHOOK_URL>' bitrix24 -- uvx bitrix24-mcp

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

{
  "mcpServers": {
    "bitrix24": {
      "command": "uvx",
      "args": [
        "bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<your BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

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

Keys and settings

BITRIX24_WEBHOOK_URLsecret, required

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 ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "bitrix24": {
      "command": "uvx",
      "args": [
        "bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<your BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

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

BITRIX24_WEBHOOK_URLsecret, required

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

code --add-mcp '{"name":"bitrix24","type":"stdio","command":"uvx","args":["bitrix24-mcp"],"env":{"BITRIX24_WEBHOOK_URL":"<your BITRIX24_WEBHOOK_URL>"}}'

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

{
  "servers": {
    "bitrix24": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<your BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

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

Keys and settings

BITRIX24_WEBHOOK_URLsecret, required

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 bitrix24 --env 'BITRIX24_WEBHOOK_URL=<your BITRIX24_WEBHOOK_URL>' -- uvx bitrix24-mcp

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

[mcp_servers.bitrix24]
command = "uvx"
args = ["bitrix24-mcp"]
env = { BITRIX24_WEBHOOK_URL = "<your BITRIX24_WEBHOOK_URL>" }

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

Keys and settings

BITRIX24_WEBHOOK_URLsecret, required

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 -e 'BITRIX24_WEBHOOK_URL=<your BITRIX24_WEBHOOK_URL>' bitrix24 uvx bitrix24-mcp

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

{
  "mcpServers": {
    "bitrix24": {
      "command": "uvx",
      "args": [
        "bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<your BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

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

Keys and settings

BITRIX24_WEBHOOK_URLsecret, required

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": {
      "command": "uvx",
      "args": [
        "bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<your BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

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

BITRIX24_WEBHOOK_URLsecret, required

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": {
      "command": "uvx",
      "args": [
        "bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<your BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

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

BITRIX24_WEBHOOK_URLsecret, required

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": {
      "command": "uvx",
      "args": [
        "bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<your BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

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

Keys and settings

BITRIX24_WEBHOOK_URLsecret, required

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": {
      "type": "local",
      "command": [
        "uvx",
        "bitrix24-mcp"
      ],
      "environment": {
        "BITRIX24_WEBHOOK_URL": "<your BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

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

Keys and settings

BITRIX24_WEBHOOK_URLsecret, required

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": {
      "command": "uvx",
      "args": [
        "bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<your BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

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

Keys and settings

BITRIX24_WEBHOOK_URLsecret, required

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 .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "bitrix24": {
      "command": "uvx",
      "args": [
        "bitrix24-mcp"
      ],
      "env": {
        "BITRIX24_WEBHOOK_URL": "<your BITRIX24_WEBHOOK_URL>"
      }
    }
  }
}

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

Keys and settings

BITRIX24_WEBHOOK_URLsecret, required

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

You will need: uv

Checked against the repository on Sep 25, 2026, commit d300775.

Text for your agent

Add the MCP server by running uvx bitrix24-mcp with the BITRIX24_WEBHOOK_URL environment variable set to your Bitrix24 portal's incoming webhook.

Other ways from the author
uvx bitrix24-mcp

Runs the PyPI package with no install step; needs the BITRIX24_WEBHOOK_URL variable.

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

What it does

The server wraps the Bitrix24 REST API into twelve tools: an arbitrary raw method call, the current user, user and department listing, filtered task listing, task creation with a deadline, chat messages, and generic CRUD for the newer crm.item entities by entityTypeId. The package is published to PyPI as bitrix24-mcp and runs with a single uvx command with no install step; configuration is just one webhook environment variable.

Who it is for. For developers who want a small, generic Bitrix24 client without extra abstractions on top of REST.

Good fit when

  • You want a quick start without cloning the repo: uvx bitrix24-mcp
  • You need generic access to the newer CRM entities (crm.item) by type
  • The direct bitrix_call passthrough is enough for methods not in the built-in set

Not a fit when

  • You need dedicated tools for classic leads, deals or contacts: the server only covers the newer crm.item entities
  • You need disk access, calls or business processes: none are included

Example request

Create a task "Prepare the report" due in three days and show the list of active employees

Limitations

The README does not list the tools, only install and run steps. The CRM tools go through crm.item and require knowing the entity's entityTypeId. There is no rate-limit handling or retry logic for Bitrix24 errors.

How to disable. Remove the bitrix24 block from your MCP client configuration.

MCP

Transport
stdio
Authentication
API key
Environment variables
Environment variables
BITRIX24_WEBHOOK_URL
required, secret
Bitrix24 incoming webhook URL

Security check

  • Tools create and delete CRM items and tasks
  • bitrix_call allows calling any API method, not just read-safe ones

README in short

A short Russian README: Python 3.10+ requirement, install via venv and pip install -r requirements.txt, the BITRIX24_WEBHOOK_URL variable, running python -m bitrix24_mcp.server, and an MCP client config snippet using uvx bitrix24-mcp. The tool list is not in the README but is visible in the package source.

FAQ

Do I need to clone the repository?

No, the package is on PyPI and runs with the uvx bitrix24-mcp command.

How do I call a method with no dedicated tool?

Through bitrix_call with the Bitrix24 method name and JSON parameters.

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

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