Bitrix24_MCP_Server

MCP Сервер для работы с Битрикс24 через LLM

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio oneatdrt-bitrix24_mcp_server node mcp-server.js \
  --env PORT="3000 (default, can be overridden by environment)" \
  --env LOG_LEVEL="info" \
  --env BITRIX_DOMAIN="your-domain.bitrix24.ru" \
  --env BITRIX_WEBHOOK_TOKEN="your-webhook-token"

How to use

This MCP server acts as an intermediary between a language model and the Bitrix24 REST API. It exposes a set of MCP tools (instruments) organized by Bitrix24 entity groups such as Leads, Deals, Contacts, Tasks, Users, Activities and more. Each instrument corresponds to a specific API operation (e.g., getLeads, createDeal, updateLead) and returns data in a structured, client-friendly format. The MCP server is designed to be run via a Node.js runtime and communicates with the language model through standard input/output, enabling seamless tool invocation by the model in a chat or analysis workflow.

How to install

Prerequisites:

Node.js 14+ installed on your system
npm 6+ (comes with Node.js installation)
Access to a Bitrix24 instance with a configured webhook

Step-by-step:

Clone the repository: git clone https://github.com/your-username/bitrix24-mcp-server.git cd bitrix24-mcp-server
Install dependencies: npm install
Create and configure environment variables. Create a .env file in the project root (example): PORT=3000 BITRIX_DOMAIN=your-domain.bitrix24.ru BITRIX_WEBHOOK_TOKEN=your-webhook-token LOG_LEVEL=info
Start the MCP server: npm start

If you prefer running directly with Node (without npm script): node mcp-server.js

Prerequisites recap: ensure your Bitrix24 domain is reachable from the server, and that the webhook token used by the MCP server has the necessary permissions to read/write the required Bitrix24 data.

Additional notes

Tips:

Secure the webhook token and store it in a safe vault or environment management system. Do not hard-code sensitive credentials.
If you run behind a proxy or in a containerized environment, ensure proper CORS configuration and allowed origins for frontend apps.
The MCP server logs requests and responses; adjust LOG_LEVEL in the .env file to control verbosity.
Common issues include network connectivity to Bitrix24, invalid domain, or expired webhook tokens. Check the Bitrix24 webhook configuration and token validity if you see authentication errors (401/403).
To extend functionality, you can add or modify instruments within the mcp-server.js and related modules to cover additional Bitrix24 endpoints or custom business logic.

Related MCP Servers

zen

1.1k

Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage

MCP -Deepseek_R1

A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)

mcp-fhir

A Model Context Protocol implementation for FHIR

mcp

Inkdrop Model Context Protocol Server

mcp-appium-gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

dubco -npm

The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.