Bitrix24 MCP Server

How to use

You connect an MCP-compatible client to the Bitrix24 MCP Server to perform CRM actions through natural language prompts. Use the available tools to create, read, update, and list CRM entities such as contacts, deals, tasks, leads, and companies. You can also search across CRM data, resolve user names for IDs, and monitor sales activities from your agent.

How to install

Prerequisites you need before installing: Node.js 18 or newer, npm or yarn, and a Bitrix24 webhook URL.

Step by step install and run flow you can follow exactly as written here.

# 1. Clone and install dependencies
git clone <repository-url>
cd bitrix24-mcp-server
npm install

# 2. Configure environment
cp .env.example .env
# Edit .env to set BITRIX24_WEBHOOK_URL
```
```bash
# 3. Build the project
npm run build
```
```bash
# 4. Start the server (stdio/MCP)
npm start
```
```bash
# 5. Test the connection
npm test

Configuration and startup notes

The server reads configuration from environment variables. At a minimum, you provide your Bitrix24 webhook URL to enable API access.

If you are using Claude Desktop or another MCP client, configure the MCP endpoint to point to the local server process started with npm start. A recommended client configuration is provided in the Claude Desktop integration section.

Notes on security and usage

Keep your webhook URL secure and rotate it periodically. Do not commit .env files to version control. The server includes rate limiting to prevent exceeding Bitrix24 API limits and masks sensitive information in error messages to avoid disclosure.

bitrix24_create_contact

Create a new contact in Bitrix24 with provided details such as name, email, and phone.

bitrix24_get_contact

Retrieve a contact by its ID from Bitrix24.

bitrix24_list_contacts

List contacts with optional filtering and pagination.

bitrix24_update_contact

Update an existing contact's fields in Bitrix24.

bitrix24_create_deal

Create a new deal in Bitrix24 and optionally link it to a contact or company.

bitrix24_get_deal

Retrieve a deal by its ID from Bitrix24.

bitrix24_list_deals

List deals with filtering options such as pipeline or stage.

bitrix24_update_deal

Update an existing deal in Bitrix24.

bitrix24_create_task

Create a new task in Bitrix24 and assign it to relevant entities.

bitrix24_get_task

Retrieve a task by its ID.

bitrix24_list_tasks

List tasks with filtering options.

bitrix24_update_task

Update an existing task.

bitrix24_get_user

Fetch user information by user ID.

bitrix24_get_all_users

Retrieve all users with names and details.

bitrix24_resolve_user_names

Resolve user IDs to human-friendly names.

bitrix24_get_contacts_with_user_names

Get contacts with resolved user names.

bitrix24_get_deals_with_user_names

Get deals with resolved user names.

bitrix24_get_leads_with_user_names

Get leads with resolved user names.

bitrix24_get_companies_with_user_names

Get companies with resolved user names.

bitrix24_create_lead

Create a new lead in Bitrix24.

bitrix24_get_lead

Retrieve a lead by ID.

bitrix24_list_leads

List leads with filtering options.

bitrix24_get_latest_leads

Get most recent leads.

bitrix24_get_leads_from_date_range

Get leads within a specific date range.

bitrix24_update_lead

Update an existing lead.

bitrix24_create_company

Create a new company in Bitrix24.

bitrix24_get_company

Retrieve a company by ID.

bitrix24_list_companies

List companies with filtering.

bitrix24_get_latest_companies

Get most recent companies.

bitrix24_get_companies_from_date_range

Get companies from a specific date range.

bitrix24_update_company

Update an existing company.

bitrix24_get_deal_pipelines

Get all deal pipelines and categories.

bitrix24_get_deal_stages

Get deal stages for pipelines.

bitrix24_filter_deals_by_pipeline

Filter deals by pipeline.

bitrix24_filter_deals_by_budget

Filter deals by budget range.

bitrix24_filter_deals_by_status

Filter deals by stage or status.

bitrix24_search_crm

Search across CRM entities using a query.

bitrix24_get_current_user

Get current authenticated user information.

bitrix24_validate_webhook

Validate that the webhook connection is properly configured.

bitrix24_diagnose_permissions

Diagnose webhook permissions for the connected user.

bitrix24_check_crm_settings

Check CRM settings and configuration for consistency.

bitrix24_test_leads_api

Test leads API endpoints for basic functionality.

bitrix24_monitor_user_activities

Monitor user activities such as calls and messages.

bitrix24_get_user_performance_summary

Get comprehensive performance metrics for a user.

bitrix24_analyze_account_performance

Analyze performance for specific Bitrix24 accounts.

bitrix24_compare_user_performance

Compare performance metrics between multiple users.

bitrix24_track_deal_progression

Track a deal’s progression through pipeline stages.

bitrix24_monitor_sales_activities

Monitor sales activities including tasks and meetings.

bitrix24_generate_sales_report

Generate customizable sales reports.

bitrix24_get_team_dashboard

Get real-time team performance dashboard.

bitrix24_analyze_customer_engagement

Analyze engagement patterns and relationship health.

bitrix24_forecast_performance

Generate performance forecasts and predictive analytics.