@theyahia/bitrix24-mcp

Name: bitrix24 mcp
Author: theyahia

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