@theyahia/bitrix24-mcp
Lightweight MCP server for Bitrix24 CRM via webhook API. 4 tools for deals, contacts, and tasks.
Lightweight alternative to the official Bitrix24 MCP -- zero dependencies beyond the MCP SDK, webhook-based auth, instant setup.
Quick Start
Claude Desktop
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": ["-y", "@theyahia/bitrix24-mcp"],
"env": {
"BITRIX24_WEBHOOK_URL": "https://your-domain.bitrix24.ru/rest/1/your-token/"
}
}
}
}
Claude Code
claude mcp add bitrix24 -e BITRIX24_WEBHOOK_URL=https://your-domain.bitrix24.ru/rest/1/token/ -- npx -y @theyahia/bitrix24-mcp
Cursor / Windsurf
{
"bitrix24": {
"command": "npx",
"args": ["-y", "@theyahia/bitrix24-mcp"],
"env": {
"BITRIX24_WEBHOOK_URL": "https://your-domain.bitrix24.ru/rest/1/your-token/"
}
}
}
Tools
| Tool | Description |
|---|---|
get_deals | List CRM deals with stage/user filters |
create_deal | Create a new CRM deal |
get_contacts | List CRM contacts with name/phone/email filters |
create_task | Create a task with deadline and priority |
Auth
| Variable | Required | Description |
|---|---|---|
BITRIX24_WEBHOOK_URL | Yes | Webhook URL (includes auth token) |
Create a webhook in Bitrix24: Applications > Webhooks > Inbound webhook.
HTTP Transport
HTTP_PORT=3000 npx @theyahia/bitrix24-mcp
# or
npx @theyahia/bitrix24-mcp --http 3000
Endpoints: POST /mcp (JSON-RPC), GET /health (status).
Skills
- skill-tasks -- create and manage Bitrix24 tasks
- skill-deals -- list and create CRM deals
License
MIT