PHPackages parfeon/mcp-bitrix24 - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. parfeon/mcp-bitrix24 ActiveLibrary[API Development](/categories/api) parfeon/mcp-bitrix24 ==================== MCP server for Bitrix24 — exposes CRM and Tasks to AI clients via Model Context Protocol v0.1.0-alpha(1mo ago)08↓66.7%Elastic-2.0PHPPHP >=8.3 Since Jun 2Pushed 1mo agoCompare [ Source](https://github.com/vadimpalgov/mcp-bitrix24)[ Packagist](https://packagist.org/packages/parfeon/mcp-bitrix24)[ RSS](/packages/parfeon-mcp-bitrix24/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (2)Versions (2)Used By (0) parfeon/mcp-bitrix24 ==================== [](#parfeonmcp-bitrix24) > **Alpha version** — API and configuration format may change without notice. Not recommended for production use. [Русская версия](README_RUS.md) Composer package that runs an MCP (Model Context Protocol) server on top of Bitrix24, allowing AI clients (Claude Desktop, Cursor, etc.) to read and manage CRM data directly via chat. How it works ------------ [](#how-it-works) Runs as a long-lived PHP CLI process. Communicates with the MCP client over **stdio** (JSON-RPC via stdin/stdout) — the standard MCP transport. The client sends a tool call, the server executes it through the Bitrix API and returns the result. Requirements ------------ [](#requirements) - PHP 8.3+ - Bitrix24 installed and accessible from the same runtime environment - Composer Installation ------------ [](#installation) ``` composer require parfeon/mcp-bitrix24 ``` Configuration ------------- [](#configuration) Add an `extra.mcp-bitrix24` section to your root `composer.json`: ``` { "extra": { "mcp-bitrix24": { "bitrix_root": "/var/www/bitrix", "admin_user_id": 1, "modules": ["crm", "tasks"] } } } ``` ParameterTypeDefaultDescription`bitrix_root`stringauto-detectAbsolute path to the Bitrix document root. If omitted, the package walks up the directory tree looking for `bitrix/modules/main/include/prolog_before.php`.`admin_user_id`int`1`Bitrix user ID used to authorize internal API calls.`modules`array`["crm", "tasks"]`Bitrix modules to load on startup. Add `"iblock"` if you use iblock-linked fields.If `bitrix_root` is not set and auto-detection fails, the server exits with: ``` [MCP] Bitrix root not found. Set extra.mcp-bitrix24.bitrix_root in composer.json ``` MCP Client Setup ---------------- [](#mcp-client-setup) ### Claude Desktop [](#claude-desktop) **Windows (Docker + WSL):** ``` { "mcpServers": { "bitrix24": { "command": "wsl", "args": ["docker", "exec", "-i", "bitrix_php", "php", "/var/www/bitrix/local/modules/bit.mcp/extension/cli/server.php"] } } } ``` Config file location: `%APPDATA%\Claude\claude_desktop_config.json` **Linux / macOS (native server):** ``` { "mcpServers": { "bitrix24": { "command": "php", "args": ["/var/www/bitrix/local/modules/bit.mcp/extension/cli/server.php"] } } } ``` **Linux / macOS (Docker):** ``` { "mcpServers": { "bitrix24": { "command": "docker", "args": ["exec", "-i", "bitrix_php", "php", "/var/www/bitrix/local/modules/bit.mcp/extension/cli/server.php"] } } } ``` **Remote server via SSH:** ``` { "mcpServers": { "bitrix24": { "command": "ssh", "args": ["user@your-server", "php", "/var/www/bitrix/local/modules/bit.mcp/extension/cli/server.php"] } } } ``` Any MCP client that supports stdio transport will work with the same pattern. Available Tools --------------- [](#available-tools) ToolDescription`crm_get_deals`List deals with optional filters (stage, responsible)`crm_get_deal`Get a single deal by ID including UF\_\* fields`crm_get_contacts`List contacts with optional name search`crm_get_contact`Get a single contact by ID`crm_get_item`Get any CRM entity item by `entityTypeId` and `id``crm_create_item`Create a CRM entity item`crm_update_item`Update fields of a CRM entity item`crm_delete_item`Delete a CRM entity item (irreversible)`crm_get_entity_fields`List all fields (ORM + UF\_\* + parent relations) for an entity type`crm_get_smart_processes`List all smart processes (custom CRM types)`crm_add_user_field`Add a user field (UF\_\*) to a CRM entity`crm_update_user_field`Update label / mandatory / sort of a user field`crm_delete_user_field`Delete a user field (irreversible)`iblock_get_elements`List iblock elements (useful for decoding iblock\_element field values)`tasks_get_list`List tasks with optional filtersRunning Environments -------------------- [](#running-environments) The server is not tied to Docker. It runs anywhere PHP 8.3+ has access to the Bitrix installation files: EnvironmentLaunch commandNative Linux / macOS`php /path/to/cli/server.php`Docker (Linux / macOS)`docker exec -i bitrix_php php /path/to/cli/server.php`Docker + WSL (Windows)`wsl docker exec -i bitrix_php php /path/to/cli/server.php`Remote server via SSH`ssh user@host php /path/to/cli/server.php`> PHP CGI / FPM is **not supported** — the server requires a CLI process with stdio. Manual Start ------------ [](#manual-start) ``` php /var/www/bitrix/local/modules/bit.mcp/extension/cli/server.php ``` Server logs are written to stderr and visible in the MCP client's log file (`%APPDATA%\Claude\logs\mcp-server-bitrix24.log` for Claude Desktop on Windows). License ------- [](#license) Copyright (c) 2025 [Vadim Palgov](https://parfeon.dev) Licensed under the [Elastic License 2.0](LICENSE). You may not redistribute, resell, or rebrand this software as your own product. See [NOTICE](NOTICE) and [LICENSE](LICENSE) for full terms. ### Health Score 35 — LowBetter than 77% of packages Maintenance90 Actively maintained with recent releases Popularity6 Limited adoption so far Community6 Small or concentrated contributor base Maturity34 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 53d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/3916db33fbc9feb0296c6484780fe0d998fe2bf83e20dea6b953dc22f676b2ee?d=identicon)[vadimpalgov](/maintainers/vadimpalgov) --- Top Contributors [![vadimpalgov](https://avatars.githubusercontent.com/u/12279998?v=4)](https://github.com/vadimpalgov "vadimpalgov (1 commits)") ### Embed Badge ![Health badge](/badges/parfeon-mcp-bitrix24/health.svg) ``` [![Health](https://phpackages.com/badges/parfeon-mcp-bitrix24/health.svg)](https://phpackages.com/packages/parfeon-mcp-bitrix24) ``` ### Alternatives [composer/composer Composer helps you declare, manage and install dependencies of PHP projects. It ensures you have the right stack everywhere. 29.5k196.2M3.2k](/packages/composer-composer)[ccxt/ccxt A cryptocurrency trading API with more than 100 exchanges in JavaScript / TypeScript / Python / C# / PHP / Go 43.2k341.0k1](/packages/ccxt-ccxt)[team-reflex/discord-php An unofficial API to interact with the voice and text service Discord. 1.1k420.9k26](/packages/team-reflex-discord-php)[whatsdiff/whatsdiff See what's changed in your project's dependencies 771.2k](/packages/whatsdiff-whatsdiff)[web3p/web3.php Ethereum web3 interface. 1.3k362.2k43](/packages/web3p-web3php)[rector/rector-src Instant Upgrade and Automated Refactoring of any PHP code 136406.3k14](/packages/rector-rector-src) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)