Bitrix24 MCP server: tasks, CRM and lists
Bitrix24 Tasks, CRM & Lists MCP Server
A modular Bitrix24 MCP server with 46 tools for tasks and kanban, CRM deals and contacts, and universal lists, running in Docker with no third-party cache
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
- The CRM module can create, update and comment on deals and contacts once confirm=true is passed
- MCP_EXTRA_MODULES runs arbitrary third-party code with the server process's permissions
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/bitrix24-tasks-crm-lists-mcp-serverDetects 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_BASE=<your BITRIX_WEBHOOK_BASE>' bitrix24-mcp -- dockerOr add to the file .mcp.json, in the project
{
"mcpServers": {
"bitrix24-mcp": {
"command": "docker",
"args": [],
"env": {
"BITRIX_WEBHOOK_BASE": "<your BITRIX_WEBHOOK_BASE>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_WEBHOOK_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
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": "docker",
"args": [],
"env": {
"BITRIX_WEBHOOK_BASE": "<your BITRIX_WEBHOOK_BASE>"
}
}
}
}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_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
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":"docker","args":[],"env":{"BITRIX_WEBHOOK_BASE":"<your BITRIX_WEBHOOK_BASE>"}}'Or add to the file .vscode/mcp.json, in the project
{
"servers": {
"bitrix24-mcp": {
"type": "stdio",
"command": "docker",
"args": [],
"env": {
"BITRIX_WEBHOOK_BASE": "<your BITRIX_WEBHOOK_BASE>"
}
}
}
}If the file already exists, add the server inside the servers key.
Keys and settings
BITRIX_WEBHOOK_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
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_BASE=<your BITRIX_WEBHOOK_BASE>' -- dockerOr add to the file ~/.codex/config.toml, for all projects
[mcp_servers.bitrix24-mcp]
command = "docker"
args = []
env = { BITRIX_WEBHOOK_BASE = "<your BITRIX_WEBHOOK_BASE>" }If the file already exists, append the block to the end.
Keys and settings
BITRIX_WEBHOOK_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
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_BASE=<your BITRIX_WEBHOOK_BASE>' bitrix24-mcp dockerOr add to the file ~/.gemini/settings.json, for all projects
{
"mcpServers": {
"bitrix24-mcp": {
"command": "docker",
"args": [],
"env": {
"BITRIX_WEBHOOK_BASE": "<your BITRIX_WEBHOOK_BASE>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_WEBHOOK_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
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": "docker",
"args": [],
"env": {
"BITRIX_WEBHOOK_BASE": "<your BITRIX_WEBHOOK_BASE>"
}
}
}
}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_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
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": "docker",
"args": [],
"env": {
"BITRIX_WEBHOOK_BASE": "<your BITRIX_WEBHOOK_BASE>"
}
}
}
}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_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
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": "docker",
"args": [],
"env": {
"BITRIX_WEBHOOK_BASE": "<your BITRIX_WEBHOOK_BASE>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_WEBHOOK_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
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": [
"docker"
],
"environment": {
"BITRIX_WEBHOOK_BASE": "<your BITRIX_WEBHOOK_BASE>"
}
}
}
}If the file already exists, add the server inside the mcp key.
Keys and settings
BITRIX_WEBHOOK_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
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": "docker",
"args": [],
"env": {
"BITRIX_WEBHOOK_BASE": "<your BITRIX_WEBHOOK_BASE>"
}
}
}
}If the file already exists, add the server inside the context_servers key.
Keys and settings
BITRIX_WEBHOOK_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
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": "docker",
"args": [],
"env": {
"BITRIX_WEBHOOK_BASE": "<your BITRIX_WEBHOOK_BASE>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
BITRIX_WEBHOOK_BASEsecret, required- секретный URL входящего webhook Bitrix24 REST API
BITRIX_DEFAULT_DEAL_CATEGORYoptional- имя CRM-воронки по умолчанию
BITRIX_DEFAULT_GROUP_IDoptional- ID проекта/группы для task-инструментов, если пользователь не указал проект
BITRIX_REPO_GROUP_MAPoptional- JSON-объект сопоставления имени репозитория с ID Bitrix24-проекта
MCP_ENABLED_MODULESoptional- список id встроенных модулей через запятую
MCP_EXTRA_MODULESoptional- сторонние модули вне репозитория: npm-пакеты и/или пути к файлам через запятую
DATABASE_URLsecret, optional- URL подключения к PostgreSQL для мультиаккаунтного HTTP-транспорта
POSTGRES_DBoptional- имя базы данных PostgreSQL
POSTGRES_USERoptional- пользователь PostgreSQL
POSTGRES_PASSWORDsecret, optional- пароль пользователя PostgreSQL
MCP_TRANSPORToptional- тип транспорта: stdio (по умолчанию) или http
MCP_HTTP_PORToptional- порт HTTP-сервера, по умолчанию 3000
MCP_PUBLIC_URLoptional- внешний HTTPS-адрес сервера, используется как OAuth issuer
MCP_AUTH_USERNAMEsecret, optional- bootstrap логин для первого аккаунта при пустой таблице mcp_accounts
MCP_AUTH_PASSWORD_HASHsecret, optional- bootstrap хэш пароля для первого аккаунта при пустой таблице mcp_accounts
MCP_TOKEN_TTL_SECONDSoptional- время жизни access токена в секундах
MCP_REFRESH_TOKEN_TTL_SECONDSoptional- время жизни refresh токена в секундах
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Copy .env.example to .env, set BITRIX_WEBHOOK_BASE, then run docker compose build and docker compose run --rm -T mcp to run over stdio, or use the project's ready .mcp.json for Cursor and Claude Desktop.
Other ways from the author
docker compose build && docker compose run --rm -T mcpThe recommended stdio run mode; set BITRIX_WEBHOOK_BASE in .env first.
This is third-party code. Review the repository files before installing.
What it does
The server is built as a core plus three pluggable modules: tasks and projects (26 tools covering connection checks, listing, history, checklists, workgroup kanban boards, sprints and time tracking), CRM (18 tools for deals, contacts, users and activities) and universal lists (2 tools for searching and downloading attachments in a correspondence registry). Modules can be disabled via the MCP_ENABLED_MODULES variable or extended with your own, including third-party npm packages outside the repository. Every write call requires an explicit confirm=true parameter, and there is no unrestricted generic REST tool: each tool validates and limits its own set of fields. By default the server runs over stdio in Docker with one shared webhook and no database; an optional second HTTP transport adds multi-account OAuth login backed by a small PostgreSQL accounts table.
Who it is for. For teams that need broad but controlled coverage of Bitrix24 tasks, CRM and lists in one server, with the option to disable modules they do not need.
Good fit when
- You need both tasks with kanban and sprints, and CRM, from a single server rather than separate ones per entity
- You want every write to explicitly require confirm=true
- You need multi-account remote access through OAuth for several claude.ai users
Not a fit when
- You need an unrestricted generic REST tool: the project deliberately does not provide one
- You have no Docker: a basic npm run is possible, but the README is container-oriented
Example request
Show the open deals in my pipeline and move task 318 to the Done column on the project kanbanLimitations
The multi-account HTTP transport keeps OAuth clients and tokens in process memory and does not survive a container restart, although the accounts themselves persist in PostgreSQL. An account's role is a descriptive field that does not gate anything by itself. Docker Engine with Compose v2 is needed for the recommended run mode. Integration tests against a real portal are gated by a separate variable and disabled by default. The project is very new with a single author and no stars.
How to disable. Stop docker compose and remove the server from .mcp.json or your MCP client configuration.
MCP
- Transport
- stdio, http
- Authentication
- OAuth
| Environment variables | |
|---|---|
| BITRIX_WEBHOOK_BASE required, secret | The secret inbound webhook URL, e.g. https://portal.example.ru/rest/123/token |
| MCP_ENABLED_MODULES | A comma-separated list of built-in modules: tasks, crm, lists; all are enabled by default |
| MCP_EXTRA_MODULES | Third-party npm packages or file paths for custom modules; they run arbitrary code |
| MCP_TRANSPORT | stdio by default, or http for the mcp-http service |
| DATABASE_URL secret | PostgreSQL connection string, needed only for the multi-account HTTP transport |
Security check
- The CRM module can create, update and comment on deals and contacts once confirm=true is passed
- MCP_EXTRA_MODULES runs arbitrary third-party code with the server process's permissions
README in short
The Russian README describes in detail the core-plus-pluggable-modules architecture, a design with no third-party data cache, running in Docker over stdio, an optional HTTP transport with multi-account OAuth backed by PostgreSQL, a full list of environment variables, a breakdown of 46 tools across three modules, and a tests and quality section covering typecheck, lint and integration checks against a real portal.
FAQ
Does the basic setup need a database?
No, PostgreSQL is only needed for the multi-account HTTP transport; a normal stdio run with one webhook works without any database.
Can I disable part of the tools?
Yes, the MCP_ENABLED_MODULES variable lets you keep only the modules you need, for example just tasks, or disable all built-in ones and load your own via MCP_EXTRA_MODULES.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
Yandex Kit skills for store management
kit-skills
Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex
YouGile MCP by Indalo
YouGile MCP
Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit
Bitrix24 portal MCP server
MCP-сервер портала Битрикс24
Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail