About io.github.theYahia/bitrix24-mcp
io.github.theYahia/bitrix24-mcp is an MCP server in the Automation category: mCP server for Bitrix24 CRM — deals, contacts, tasks via webhook API.
Install
claude mcp add io-github-theyahia-bitrix24-mcp -- npx -y @theyahia/bitrix24-mcpnpx -y @theyahia/bitrix24-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (12)
complete_taskMark a Bitrix24 task as completed by task ID.
Parameters not published.
create_contactCreate a new CRM contact with name, last name, phone, and email.
Parameters not published.
create_dealCreate a new CRM deal in Bitrix24 with title, amount, stage, and linked contact/company.
Parameters not published.
create_taskCreate a new task in Bitrix24 with title, description, responsible user, and deadline.
Parameters not published.
get_dealGet a single CRM deal by ID with all fields.
Parameters not published.
list_contactsList CRM contacts from Bitrix24 with optional filters by name, phone, or email.
Parameters not published.
list_dealsList CRM deals from Bitrix24 with optional filters by stage, responsible user, and sort order.
Parameters not published.
list_tasksList tasks from Bitrix24 with optional filters by status, responsible user, and group.
Parameters not published.
list_usersList Bitrix24 users with optional filters by active status and department.
Parameters not published.
send_messageSend an instant message via Bitrix24 IM to a user or chat.
Parameters not published.
update_dealUpdate an existing CRM deal fields: title, stage, amount, contacts, etc.
Parameters not published.
upload_fileUpload a file to Bitrix24 disk folder (base64-encoded content).
Parameters not published.
Ask AI
Ask AI about io.github.theYahia/bitrix24-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
@theyahia/bitrix24-mcp
MCP server for Bitrix24 CRM via webhook API. 12 tools for deals, contacts, tasks, users, files, and messaging.
Part of the Russian API MCP series by @theYahia.
Setup
- In Bitrix24, go to Developer resources > Other > Inbound webhook
- Create a webhook with permissions:
crm,task,user,disk,im - Copy the full webhook URL
Usage with Claude Desktop
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": ["-y", "@theyahia/bitrix24-mcp"],
"env": {
"BITRIX24_WEBHOOK_URL": "https://your-company.bitrix24.ru/rest/1/your-webhook-key/"
}
}
}
}
Claude Code
claude mcp add bitrix24 -e BITRIX24_WEBHOOK_URL=https://your.bitrix24.ru/rest/1/key/ -- npx -y @theyahia/bitrix24-mcp
Tools (12)
| Tool | Description |
|---|---|
list_deals |
List CRM deals with filters by stage, user, sort order |
get_deal |
Get a single deal by ID |
create_deal |
Create a deal with title, amount, stage, contacts |
update_deal |
Update deal fields |
list_contacts |
List contacts with filters by name, phone, email |
create_contact |
Create a contact with name, phone, email |
list_tasks |
List tasks with filters by status, user, group |
create_task |
Create a task with title, deadline, priority |
complete_task |
Mark a task as completed |
list_users |
List users with filters by active status, department |
upload_file |
Upload a file to Bitrix24 disk |
send_message |
Send an IM message to a user or chat |
Demo Prompts
Show me all open deals in Bitrix24
Create a deal "Website redesign" for 500000 RUB
List all contacts with email containing "@gmail.com"
Create a task "Prepare presentation" for user 5, deadline tomorrow
Complete task 123
Who are the active users in department 2?
Send a message to user 1: "Meeting in 15 minutes"
Environment Variables
| Variable | Required | Description |
|---|---|---|
BITRIX24_WEBHOOK_URL |
Yes | Full Bitrix24 webhook URL including auth key |
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.