Bitrix24 MCP server template
bx24-template-mcp
Bitrix24's official MCP server template on Nuxt: ready tools for tasks and users, three deployment options
- 6 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Creates, changes and deletes task data in a production portal
- The webhook grants access with its creator's permissions
- With a GitHub token set, the agent can file issues in a public repository
Install
- Works in
- Services
Manual install
git clone https://github.com/bitrix24/templates-mcp.git
cd templates-mcp
cp .env.example .env
pnpm install
pnpm build
pnpm startBefore starting, set NUXT_BITRIX24_WEBHOOK_URL and NUXT_MCP_AUTH_TOKEN in .env. The server listens on http://localhost:3000/mcp.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Creates, changes and deletes task data in a production portal
- The webhook grants access with its creator's permissions
- With a GitHub token set, the agent can file issues in a public repository
This is third-party code. Review the repository files before installing.
What it does
The project is both a working MCP server and a base for your own. Out of the box the agent creates and updates tasks, moves them through statuses, and handles checklists, results, time tracking, dependencies and comments, plus user lookup by name. It installs as a Claude Desktop extension file, a local HTTP server or a Docker container with TLS and per-user OAuth. It uses the official b24jssdk, rate limiting, webhook secret redaction in logs and tests.
Who it is for. Bitrix24 teams that want to run tasks through an agent and developers building their own MCP server for a portal.
Good fit when
- You want to create and close Bitrix24 tasks in plain language
- You need a base for your own MCP server with auth and tests
- You need to connect an agent to self-hosted Bitrix24
Not a fit when
- You need CRM deals and contacts: the current version does not cover them
- You only need REST API method reference without portal access
Example request
Create a task for Ivan Petrov to prepare the budget by Friday 18:00 with high priority and add a three-item checklistMCP
- Transport
- http
- Authentication
- API key
Environment variables
NUXT_BITRIX24_WEBHOOK_URLrequired, secret- Inbound portal webhook URL with user and task scopes
NUXT_MCP_AUTH_TOKENrequired, secret- Bearer token clients use to access /mcp
NUXT_BITRIX24_OAUTH_ENABLED- Enables per-user OAuth instead of a shared webhook
Limitations
Only tasks and user lookup are covered now; CRM is planned. Local and server modes need Node.js 22 and pnpm, and you need an inbound portal webhook with user and task scopes. The webhook acts with its creator's permissions, so the authors recommend a dedicated service account. Before 1.0 tool names may change between minor releases. The feedback tool files GitHub issues if a GitHub token is set.
How to disable. Remove it with claude mcp remove bx24 or delete the bx24 block from the client config; remove the Claude Desktop extension under Extensions. Disable the webhook in portal settings.
FAQ
Can I skip the terminal?
Yes, a ready .dxt file is attached to GitHub releases. Install it in Claude Desktop via Settings, Extensions, Install from file and paste the webhook URL.
Does it work with self-hosted Bitrix24?
Yes, both cloud and self-hosted are supported. For an internal certificate authority set NODE_EXTRA_CA_CERTS.
Discussion
No questions or reviews yet.
Related
All Bitrix24 toolsBitrix24 MCP server with real calls
MCP Server for Bitrix24
A Bitrix24 MCP server with 43 tools and about 870 actions that executes real REST API calls instead of just serving documentation
Bitrix24 Nuxt dashboard template skill
Nuxt Dashboard Template
Bitrix24's official Nuxt dashboard starter built on b24ui, shipped with mock data and a skill that guides development inside the template's architecture
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
Bitrix24 MCP by Bit2Beat
Bitrix24 MCP Server
Bitrix24 MCP server over an inbound webhook: CRM, tasks, disk, calendar, chat, business processes and config migration between portals
A compact Bitrix24 MCP server on an inbound webhook: tasks, groups, kanban stages and task comments
Bitrix24 MCP Server (gunnit)
Bitrix24 MCP Server
A TypeScript MCP server for Bitrix24 CRM: contacts, companies, leads, deals, tasks and sales rep performance reports
README in short
The README offers three install paths for different users: a Claude Desktop extension, a local HTTP server and Docker for teams. It has a full tool table including batch mode for status and checklist changes. It covers webhook setup, connecting Claude Code, Cursor and Claude Desktop, self-hosted portals, secret storage and time zones in deadlines. It states that the server sends no telemetry. MIT license.