Bitrix24 MCP server template
bx24-template-mcp
Bitrix24's official MCP server template on Nuxt: ready tools for tasks and users, three deployment options
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.
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 checklistLimitations
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.
MCP
- Transport
- http
- Authentication
- API key
| Environment variables | |
|---|---|
| NUXT_BITRIX24_WEBHOOK_URL required, secret | Inbound portal webhook URL with user and task scopes |
| NUXT_MCP_AUTH_TOKEN required, secret | Bearer token clients use to access /mcp |
| NUXT_BITRIX24_OAUTH_ENABLED | Enables per-user OAuth instead of a shared webhook |
Security check
- 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
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.
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.
Related
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI
Anthropic's official plugins for knowledge work roles: sales, support, product, marketing, legal, finance, data and enterprise search