🚀 Bitrix24 MCP Server

✅ Server Running

Protocol: MCP HTTP Streamable (2025-03-26)

Endpoint: http://localhost:3000/mcp

📋 Server Information

🔧 API Endpoints

📖 Usage Example - List Tools

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

📖 Usage Example - Call Tool

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "bitrix24_get_latest_contacts",
      "arguments": {
        "limit": 5
      }
    }
  }'

🛠 Available Tools (73)

bitrix24_create_contact - Create a new contact in Bitrix24 CRM
bitrix24_get_contact - Retrieve contact information by ID
bitrix24_list_contacts - List contacts with optional filtering
bitrix24_get_latest_contacts - Get the most recent contacts ordered by creation date
bitrix24_update_contact - Update an existing contact in Bitrix24 CRM
bitrix24_create_deal - Create a new deal in Bitrix24 CRM
bitrix24_get_deal - Retrieve deal information by ID
bitrix24_list_deals - List deals with optional filtering and ordering. By default, only active (non-closed) deals are returned.
bitrix24_get_latest_deals - Get the most recent deals ordered by creation date. By default, only active (non-closed) deals are returned.
bitrix24_get_deals_from_date_range - Get deals created within a specific date range
bitrix24_update_deal - Update an existing deal in Bitrix24 CRM
bitrix24_create_lead - Create a new lead in Bitrix24 CRM
bitrix24_get_lead - Retrieve lead information by ID
bitrix24_list_leads - List leads with optional filtering and ordering. By default, only active leads (in processing) are returned.
bitrix24_get_latest_leads - Get the most recent leads ordered by creation date. By default, only active leads (in processing) are returned.
bitrix24_get_leads_from_date_range - Get leads created within a specific date range
bitrix24_update_lead - Update an existing lead in Bitrix24 CRM
bitrix24_create_company - Create a new company in Bitrix24 CRM
bitrix24_get_company - Retrieve company information by ID
bitrix24_list_companies - List companies with optional filtering and ordering
bitrix24_update_company - Update an existing company in Bitrix24 CRM
bitrix24_get_latest_companies - Get the most recent companies ordered by creation date
bitrix24_get_companies_from_date_range - Get companies created within a specific date range
bitrix24_create_group - Create a new group or project in Bitrix24
bitrix24_get_group - Retrieve group/project information by ID
bitrix24_list_groups - List all groups/projects with optional filtering. By default, only active groups are returned.
bitrix24_list_projects - List only projects (groups with PROJECT=Y). By default, only active projects are returned.
bitrix24_list_projects_with_members - Get all projects with their members in one request. Returns projects with member details including user names and roles.
bitrix24_search_projects - Search projects by name using partial match (case-insensitive). Useful when you know part of the project name.
bitrix24_update_group - Update an existing group or project in Bitrix24
bitrix24_delete_group - Delete a group or project from Bitrix24
bitrix24_get_user_groups - Get all groups/projects where a user is a member
bitrix24_add_group_user - Add a user to a group or project
bitrix24_remove_group_user - Remove a user from a group or project
bitrix24_get_group_users - Get all members of a group or project
bitrix24_update_group_user_role - Update user role in a group or project
bitrix24_get_group_subjects - Get available group/project subjects/categories
bitrix24_create_task - Create a new task in Bitrix24
bitrix24_get_task - Retrieve task information by ID
bitrix24_list_tasks - List tasks with optional filtering and ordering. By default, only active tasks (pending, in progress, waiting for control) are returned.
bitrix24_update_task - Update an existing task in Bitrix24
bitrix24_search_crm - Search across CRM entities (contacts, companies, deals, leads)
bitrix24_validate_webhook - Validate the Bitrix24 webhook connection
bitrix24_diagnose_permissions - Diagnose webhook permissions and access to different CRM entities
bitrix24_check_crm_settings - Check CRM settings including lead fields, statuses, and mode
bitrix24_test_leads_api - Test various leads API endpoints to identify specific issues
bitrix24_get_deal_pipelines - Get all available deal pipelines/categories with their IDs and names
bitrix24_get_deal_stages - Get all deal stages for a specific pipeline or all pipelines
bitrix24_filter_deals_by_pipeline - Filter deals by specific pipeline/category ID
bitrix24_filter_deals_by_budget - Filter deals by budget/opportunity amount range
bitrix24_filter_deals_by_status - Filter deals by stage/status IDs
bitrix24_monitor_user_activities - Monitor user activities including calls, emails, timeline interactions, and response times
bitrix24_get_user_performance_summary - Get comprehensive performance summary for users including deal metrics and conversion rates
bitrix24_analyze_account_performance - Analyze performance and activities for specific accounts (companies/contacts)
bitrix24_compare_user_performance - Compare performance metrics between multiple users
bitrix24_track_deal_progression - Track deal progression through pipeline stages with timing analysis
bitrix24_monitor_sales_activities - Monitor sales-related activities including tasks, follow-ups, and meetings
bitrix24_generate_sales_report - Generate comprehensive sales report with customizable metrics and date ranges
bitrix24_get_team_dashboard - Get real-time team performance dashboard with key metrics and alerts
bitrix24_analyze_customer_engagement - Analyze customer engagement patterns and relationship health
bitrix24_forecast_performance - Generate performance forecasts and predictive analytics
bitrix24_get_user - Get user information by ID
bitrix24_get_all_users - Get all users in the system with their names and details
bitrix24_resolve_user_names - Resolve user IDs to user names
bitrix24_get_contacts_with_user_names - Get contacts with user names resolved (assigned, created, modified by)
bitrix24_get_deals_with_user_names - Get deals with user names resolved (assigned, created, modified by)
bitrix24_get_leads_with_user_names - Get leads with user names resolved (assigned, created, modified by)
bitrix24_get_companies_with_user_names - Get companies with user names resolved (assigned, created, modified by)
bitrix24_get_openlines_config - Get list of configured Open Lines channels for analytics
bitrix24_get_openlines_recent_chats - Get recent Open Lines chats with pagination support
bitrix24_get_openline_dialog - Get Open Line session details (requires at least one parameter: chatId, sessionId, or userCode)
bitrix24_get_openline_messages - Get Open Line message history with pagination support
bitrix24_get_openlines_activities - Get Open Lines activities from CRM for analytics (main method for Open Lines analytics)

🔗 MCP Client Configuration

To use this server with MCP-compatible clients (Claude Desktop, etc.), configure:

{
  "mcpServers": {
    "bitrix24": {
      "transport": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}