Bitrix24 MCP Server (NeedMoarr)
bitrix24-mcp
A single-file Bitrix24 MCP run with uv: tasks with checklists, chats, calendar, CRM deals and a daily digest
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
- It can create tasks, calendar events and send messages as the webhook
- The webhook with broad permissions is stored only in an env variable
- It reads chat and task correspondence
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/needmoarr-bitrix24-mcpDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Assembled automatically, review before installing.
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 'BITRIX_WEBHOOK_URL=<your BITRIX_WEBHOOK_URL>' bitrix24-mcp -- uvx run server.pyOr add to the file .mcp.json, in the project
{
"mcpServers": {
"bitrix24-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<your BITRIX_WEBHOOK_URL>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
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-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<your BITRIX_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
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
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-mcp","type":"stdio","command":"uvx","args":["run","server.py"],"env":{"BITRIX_WEBHOOK_URL":"<your BITRIX_WEBHOOK_URL>"}}'Or add to the file .vscode/mcp.json, in the project
{
"servers": {
"bitrix24-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<your BITRIX_WEBHOOK_URL>"
}
}
}
}If the file already exists, add the server inside the servers key.
Keys and settings
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
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-mcp --env 'BITRIX_WEBHOOK_URL=<your BITRIX_WEBHOOK_URL>' -- uvx run server.pyOr add to the file ~/.codex/config.toml, for all projects
[mcp_servers.bitrix24-mcp]
command = "uvx"
args = ["run", "server.py"]
env = { BITRIX_WEBHOOK_URL = "<your BITRIX_WEBHOOK_URL>" }If the file already exists, append the block to the end.
Keys and settings
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
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 'BITRIX_WEBHOOK_URL=<your BITRIX_WEBHOOK_URL>' bitrix24-mcp uvx run server.pyOr add to the file ~/.gemini/settings.json, for all projects
{
"mcpServers": {
"bitrix24-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<your BITRIX_WEBHOOK_URL>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
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": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<your BITRIX_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
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
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": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<your BITRIX_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
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
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": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<your BITRIX_WEBHOOK_URL>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
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": {
"type": "local",
"command": [
"uvx",
"run",
"server.py"
],
"environment": {
"BITRIX_WEBHOOK_URL": "<your BITRIX_WEBHOOK_URL>"
}
}
}
}If the file already exists, add the server inside the mcp key.
Keys and settings
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
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": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<your BITRIX_WEBHOOK_URL>"
}
}
}
}If the file already exists, add the server inside the context_servers key.
Keys and settings
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
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-mcp": {
"command": "uvx",
"args": [
"run",
"server.py"
],
"env": {
"BITRIX_WEBHOOK_URL": "<your BITRIX_WEBHOOK_URL>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_WEBHOOK_URLsecret, required- URL входящего вебхука Bitrix24
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Install uv, download server.py from NeedMoarr/bitrix24-mcp, and register it in Claude Code with claude mcp add --scope user bitrix24 -e BITRIX_WEBHOOK_URL='<your webhook>' -- uv run <path to server.py>.
Other ways from the author
claude mcp add --scope user bitrix24 -e BITRIX_WEBHOOK_URL='https://<portal>.bitrix24.ru/rest/<user_id>/<token>/' -- uv run /path/to/server.pyThe command from the README; replace the server.py path and webhook with your own.
This is third-party code. Review the repository files before installing.
What it does
The server is a single Python file, server.py, with a PEP 723 header, run via uv run, which pulls its own dependencies. Through the portal's inbound webhook it exposes more than fifteen tools: a full task cycle with BB-code, checklists and comments read from the task's chat, recent dialogs and sending messages only on explicit user request, staff search and the company structure, calendar events, CRM deals, call stats via telephony, and a daily digest of overdue items, week deadlines, open tasks and unread chats.
Who it is for. For people who want one personal MCP server covering Bitrix24 tasks, chats, calendar and deals at once.
Good fit when
- You want a daily digest of overdue items, deadlines and unread chats
- You want tasks, chats and calendar covered by one server
- You want to run the server with uv run without manually installing dependencies
Not a fit when
- You need tests and a stable public release
- You need to work with several portals at once
Example request
Give me the daily digest: what is overdue, what deadlines are this week, and what is unread in chatsLimitations
A single file with no tests or license; the README shows a server registration command with the author's own local machine path, which needs rewriting for your system. Call stats via voximplant are noted in the README as possibly empty on the author's specific portal. The token is passed only through an environment variable, with no rotation.
How to disable. Remove the server with claude mcp remove bitrix24 in user scope, or delete the block from your client config.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| BITRIX_WEBHOOK_URL required, secret | Bitrix24 portal inbound webhook URL with extended permissions |
Security check
- It can create tasks, calendar events and send messages as the webhook
- The webhook with broad permissions is stored only in an env variable
- It reads chat and task correspondence
README in short
The Russian README groups more than fifteen tools into sections: tasks, chats and messages, and the rest (staff, groups, calendar, deals, calls, digest, profile). It gives a Claude Code registration example with uv run, a list of webhook permissions expanded on August 14, 2026, and a note that task comments actually live in chats rather than the legacy task.commentitem.getlist method.
FAQ
Do I need to install dependencies by hand?
No, uv run installs them itself from the PEP 723 header at the top of server.py.
Does the server message staff on its own?
The README explicitly says to call chat_send only on the user's explicit request, not on the agent's own initiative.
Related
An MCP server with n8n node and template knowledge: the agent picks nodes, validates configs and, with API access, creates workflows in your n8n
Zapier's official MCP plugin: the agent gets actions across thousands of apps through your Zapier account
Awesome Claude Skills by Composio
Awesome Claude Skills
A curated list of Claude skills and plugins, plus Composio's own automation skills for 78 SaaS apps
A plugin and CLI catalog for agents: generates command-line interfaces for GUI apps like GIMP and Blender and installs ready ones via CLI-Hub