# bit2beat/bitrix24-mcp [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/bit2beat/bitrix24-mcp  
**GitHub Stars:** 5  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/bit2beat-bitrix24-mcp

## Description
MCP server that connects Claude to Bitrix24 — CRM, tasks, disk, calendar, chat, business processes, telephony and product catalog. Built by Bit2Beat.

## Tools
Capabilities this server exposes over MCP:

- **b24_test_connection** — Verify the webhook and confirm portal info and user permissions.
- **b24_crm_list** — List CRM records with filters and automatic pagination.
- **b24_crm_get** — Get a single CRM record by ID.
- **b24_crm_create** — Create a new CRM record.
- **b24_crm_update** — Update an existing CRM record.
- **b24_crm_delete** — Delete a CRM record.
- **b24_crm_fields** — List all available fields for an entity (standard + custom).
- **b24_crm_timeline_add** — Add a comment or activity to a CRM record's timeline.
- **b24_tasks_list** — List tasks with filters.
- **b24_tasks_get** — Get full task detail.
- **b24_tasks_create** — Create a new task.
- **b24_tasks_update** — Update an existing task.
- **b24_tasks_complete** — Mark a task as complete.
- **b24_users_list** — List active users.
- **b24_departments_list** — List departments with hierarchy.
- **b24_disk_storages** — List available storages.
- **b24_disk_folder_list** — Browse a folder's contents.
- **b24_disk_file_get** — Get file info and download URL.
- **b24_disk_file_upload** — Upload a file to a folder.
- **b24_calendar_list** — List calendar events.
- **b24_calendar_create** — Create a calendar event.
- **b24_chat_send** — Send a private or group chat message.
- **b24_notify_send** — Send a personal notification.
- **b24_feed_post** — Post to the Live Feed.
- **b24_groups_list** — List workgroups and projects.
- **b24_bizproc_list** — List active workflow instances.
- **b24_bizproc_start** — Start a business process on a record.
- **b24_telephony_calls** — Query the call history log.
- **b24_products_list** — List catalog products.
- **b24_products_get** — Get product detail.
- **b24_products_create** — Create a product.
- **b24_products_update** — Update a product.
- **b24_products_sections** — List catalog sections.
- **b24_read_full_config** — Export the complete portal configuration to JSON.
- **b24_read_entity_types** — Read CRM and SPA entity types.
- **b24_read_pipelines** — Read pipelines and their stages.
- **b24_read_custom_fields** — Read custom fields across all CRM entities.
- **b24_read_automations** — Read automation rules by stage.
- **b24_read_product_catalog** — Read the product catalog structure.
- **b24_compare_configs** — Compare two portal config JSON files.
- **b24_apply_config** — Apply an exported config to a target portal.
- **b24_save_user_mapping** — Generate a user ID mapping between two portals.
- **b24_call** — Call any Bitrix24 REST API method directly.
- **b24_batch** — Execute multiple API calls in a single HTTP request.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "bitrix24-mcp": {
    "command": "npx",
    "args": ["-y","bit2beat-bitrix24-mcp"],
    "env": {
      "B24_DEFAULT_WEBHOOK": ""
    }
  }
}
```

**Requires environment variables:** `B24_DEFAULT_WEBHOOK` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What bit2beat/bitrix24-mcp MCP server does

The bit2beat/bitrix24-mcp MCP server gives Claude access to selected Bitrix24 portal operations over the Model Context Protocol. Its documented coverage spans CRM entities, tasks, users, departments, disk storage, calendars, chat, notifications, the Live Feed, workgroups, business processes, telephony call history, and the product catalog.

CRM tools can list records with filters and pagination, retrieve individual records, inspect standard and custom fields, create, update, or delete records, and add timeline comments or activities. Task tools support listing, detail retrieval, creation, updates, and completion. File-related tools can browse storages and folders, retrieve file metadata and download links, and upload files.

The README also documents portal configuration operations, including exporting configuration data, comparing configurations, and applying a configuration to another portal. It describes a raw Bitrix24 REST option for direct method and batch requests, although the supplied tool list does not enumerate those operations individually.

## How it works

The bit2beat/bitrix24-mcp MCP server calls Bitrix24 through an incoming webhook URL stored in the `B24_DEFAULT_WEBHOOK` environment variable. The webhook is created by a Bitrix24 portal administrator and includes scopes such as `crm`, `task`, `disk`, `calendar`, `im`, `bizproc`, `catalog`, and `telephony`.

Bitrix24 scopes permit both reading and writing within an enabled module; they do not provide a built-in read-only mode. A reduced set of scopes can limit which modules are reachable, but it cannot technically prevent writes inside an enabled scope. The README describes a trust-based read-only approach and a separate instance with only read tools as alternatives. Tools report when a requested operation requires a scope that the webhook does not have.

## Setup and configuration

The project requires Node.js 18 or later and is intended for Claude Desktop or Claude Code. Setup involves cloning the repository, running `npm install`, creating an incoming Bitrix24 webhook, and placing a Node command in the Claude Desktop MCP configuration. The command points to the local `index.js` file and passes `B24_DEFAULT_WEBHOOK` in the server environment.

The webhook URL grants API access to the portal and should be kept private. Administrators can later return to Bitrix24's Applications, Webhooks, and Incoming webhooks settings to change its permissions. After editing the Claude Desktop configuration, restart the client so the tools become available.

## Tools and capabilities

- Test the webhook and inspect portal and user-permission information.
- Manage CRM records, fields, and timeline entries.
- List, create, update, and complete tasks.
- Inspect users, departments, groups, and projects.
- Browse and upload Bitrix24 disk files.
- List and create calendar events.
- Send chat messages, personal notifications, and Live Feed posts.
- List active workflows and start a business process on a record.
- Query telephony call history and product details.

## Limitations and notes

The bit2beat/bitrix24-mcp MCP server depends on the permissions and scopes of the configured Bitrix24 webhook. Creating that webhook requires administrator access. The supplied documentation describes write-capable module scopes, so access should be planned carefully when the agent is used for reporting or analysis. The repository setup also assumes a local Node.js installation and a locally cloned project rather than a hosted endpoint.

_Full upstream README: https://allmcps.com/mcp/bit2beat-bitrix24-mcp/readme_