
bit2beat/bitrix24-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
MCP server that connects Claude AI to Bitrix24 — CRM, tasks, disk, calendar, automations and more
개요
A Model Context Protocol (MCP) server that connects to your portal via an incoming webhook. Once configured, Claude can read and write CRM records, manage tasks, browse your disk, send notifications, query the product catalog, run business processes, and much more — all from natural conversation. Built and maintained by — Bitrix24 specialists. - Node.js - Claude Desktop or Claude Code - A Bitrix24 incoming webhook URL Only a Bitrix24 portal administrator can create incoming webhooks. This is a platform security restriction — webhooks act as system-level credentials and can carry broader permissions than a regular user session. 1. Log in to your Bitrix24 portal as an 2. Go to (left sidebar) → 3. Click → 4. Give it a descriptive name (e.g. Claude MCP) 5. Under , enable the scopes you need (see Access Profiles below) 6. Click 7. Copy the generated URL — it looks like: This URL is your B24_DEFAULT_WEBHOOK. — it grants API access to your portal.
README
원문 README의 일부입니다. 원문 보기.
Bitrix24 MCP Server
A Model Context Protocol (MCP) server that connects Claude to your Bitrix24 portal via an incoming webhook.
Once configured, Claude can read and write CRM records, manage tasks, browse your disk, send notifications, query the product catalog, run business processes, and much more — all from natural conversation.
Built and maintained by Bit2Beat — Bitrix24 specialists.
Features
| Area | What Claude can do |
|---|---|
| CRM | List, get, create, update, and delete deals, contacts, companies, leads, and Smart Process items. Add timeline comments. |
| Tasks | List, get, create, update, and complete tasks. |
| Users & Departments | List active users and the organizational structure. |
| Disk | Browse storages and folders, get file info and download links, upload files. |
| Calendar | List and create calendar events. |
| Chat & Notifications | Send private messages and personal notifications. |
| Live Feed | Post messages to the activity feed. |
| Groups | List workgroups and projects. |
| Business Processes | List active workflows and start new ones. |
| Telephony | Query the call history log. |
| Product Catalog | List, get, create, and update products and sections. |
| Configuration | Export the full portal config (pipelines, stages, custom fields, automations) to JSON, compare two configs, and apply one config to another portal. |
| Raw API | Call any Bitrix24 REST method directly, including batch requests. |
Requirements
- Node.js 18 or higher
- Claude Desktop or Claude Code
- A Bitrix24 incoming webhook URL
Installation
1. Clone the repository
git clone https://github.com/bit2beat/bitrix24-mcp.git
cd bitrix24-mcp
2. Install dependencies
npm install
3. Create your Bitrix24 webhook
Administrator required. Only a Bitrix24 portal administrator can create incoming webhooks. This is a platform security restriction — webhooks act as system-level credentials and can carry broader permissions than a regular user session.
Step-by-step
- Log in to your Bitrix24 portal as an administrator
- Go to Applications (left sidebar) → Webhooks
- Click Incoming webhooks → Add webhook
- Give it a descriptive name (e.g.
Claude MCP) - Under Permissions, enable the scopes you need (see Access Profiles below)
- Click Save
- Copy the generated URL — it looks like:
This URL is yourhttps://your-portal.bitrix24.com/rest/1/abc123xyz/B24_DEFAULT_WEBHOOK. Keep it private — it grants API access to your portal.
Where to find it later
If you need to edit the webhook or add more scopes after the initial setup:
Applications → Webhooks → Incoming webhooks → (click your webhook name)
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"bitrix24": {
"command": "node",
"args": ["C:/full/path/to/bitrix24-mcp/index.js"],
"env": {
"B24_DEFAULT_WEBHOOK": "https://your-portal.bitrix24.com/rest/1/your-token/"
}
}
}
}