bitrix24-mcp is an MCP server for AI assistants, used to connect AI assistants such as Claude and Cursor to Bitrix24 CRM. It connects via an inbound webhook, requires no app creation in the Bitrix24 Marketplace, and requires no OAuth authorization, making the setup process relatively quick.
Main capabilities
- Data operations: search, read, and edit deals, leads, contacts, tasks, and timeline comments. You can create deals with contacts and find contacts by phone or email (including duplicate search).
- Sales analytics: provides funnel reports, including stage-by-stage summaries, win rate, average sales cycle, and manager leaderboard; identifies stalled deals with no activity and no incomplete tasks; lists overdue tasks by employee.
- Interaction examples: you can ask "How were sales in September? Which manager closed better?" "Which deals have been stalled for more than a week, and for what amount?" "What overdue items do the managers have today?" "Find customer +7 900 123-45-67 and help me prepare for the call" "Create a 90,000 'Cafe Website' deal in the 'Projects' funnel, with contact Ivan, phone +7 900..., and assign Anna a task to call back tomorrow."
- Write operation confirmation: operations that modify portal data first show what will be written and require user confirmation.
How to use
- In Bitrix24, go to "Developer Resources → Other → Inbound Webhook", check the CRM (crm), tasks (task), and users (user) permissions, and save.
- Copy the webhook URL, in a format similar to https://你的门户.bitrix24.ru/rest/1/abc123xyz/，将其设置为环境变量 BITRIX24_WEBHOOK_URL.
- Requires Node.js 18+.
- In clients such as Cursor and Windsurf, use the npx command with the argument -y github:penmadebykisss/bitrix24-mcp, and configure the BITRIX24_WEBHOOK_URL environment variable.
Use cases
- Sales teams quickly query sales progress, manager performance, and funnel conversion.
- Managers automatically obtain sales operations information that would otherwise require manual compilation, such as stalled deals and overdue tasks.
- Create or update CRM records in conversation through an AI assistant, reducing manual operations.
Limitations and notes
- The webhook runs as the employee who created it, and its visibility scope matches that employee's, so the webhook URL should be kept secure like a password.
- The webhook's REST API limit is about 2 requests per second; the server automatically controls the interval and retries when encountering QUERY_LIMIT_EXCEEDED.
- A funnel report counts at most 2,000 deals at a time; stalled deal search scans at most 1,000 open deals.
- Supports self-hosted Bitrix24, with the webhook URL located on your own domain.
- Official materials also mention that paid deployment and customization services are available, but do not provide specific pricing, billing methods, or service scope details.
