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

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

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

needmoarr/bitrix24-mcp

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/needmoarr-bitrix24-mcp

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

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

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

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

You will need: uv

Checked against the repository on Sep 26, 2026, commit 742bc35.

Text for your agent

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

The 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 chats

Limitations

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

Editors’ pick

An MCP server with n8n node and template knowledge: the agent picks nodes, validates configs and, with API access, creates workflows in your n8n

MCP serverHigh riskNo VPN needed23KRepository stars
Official

Zapier's official MCP plugin: the agent gets actions across thousands of apps through your Zapier account

PluginHigh risk421Repository stars

A curated list of Claude skills and plugins, plus Composio's own automation skills for 78 SaaS apps

SkillHigh risk75.8KRepository stars

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

PluginHigh riskNo VPN needed50.9KRepository stars
Foxx AIBitrix24 MCP Server (NeedMoarr)

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