@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

1. In Bitrix24, go to Developer resources > Other > Inbound webhook
2. Create a webhook with permissions: crm, task, user, disk, im
3. 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