Kommo Crm

MCP (Model Context Protocol) Server for Kommo CRM. This server enables AI assistants like Claude to interact with your Kommo CRM data, including leads, contacts, companies, tasks, and more.

---

Quer Enviar Mensagens pelo Kommo?

Este MCP gerencia Leads, Contatos, Empresas e Tarefas, mas NAO envia mensagens.

Para enviar mensagens via WhatsApp, Instagram e Telegram pelo Kommo, acesse a Comunidade Kommo Brasil e tenha acesso ao nosso Widget GRATUITO!

Acesse a Comunidade Kommo Brasil

O que voce ganha na comunidade:

• Widget 100% GRATUITO para envio de mensagens pelo Kommo
• Networking com profissionais e empresarios
• Tutoriais ao vivo DIARIOS
• Grupo exclusivo no WhatsApp
• Mais de 150 aulas gravadas
• Suporte tecnico da comunidade

Entrar na Comunidade

---

Features

• Leads Management: List, get, create, update leads with full support for custom fields, tags, and linked entities
• Contacts Management: Full CRUD operations for contacts with phone, email, and custom fields
• Companies Management: Create and manage company records
• Tasks Management: Create, list, and complete tasks linked to any entity
• Pipelines & Statuses: Access pipeline configurations and lead statuses
• Users: List and get user information
• Notes: Add and read notes on any entity
• Custom Fields: Access custom field definitions
• Tags: Manage tags across entities
• Search: Global search across leads, contacts, and companies
• Webhooks: Configure webhook subscriptions

Installation

From npm (recommended)

npm install -g kommo-mcp-server

From source

git clone https://github.com/LUIZOTAVIOENGENHARIADIGITAL/mcp-server-kommo-crm.git
cd mcp-server-kommo-crm
npm install
npm run build

Configuration

1. Get Kommo API Credentials

1. Log in to your Kommo account
2. Go to Settings → Integrations
3. Click Create Integration
4. Fill in the required fields and save
5. Copy the Client ID and Client Secret
6. Complete the OAuth flow to get your Access Token and Refresh Token

For private integrations, you can also use long-lived tokens directly from the integration settings.

2. Configure Environment Variables

Create a .env file or set these environment variables:

# Required
KOMMO_SUBDOMAIN=your-subdomain      # Your Kommo subdomain (e.g., "mycompany" from mycompany.kommo.com)
KOMMO_ACCESS_TOKEN=your-access-token

# Optional (for automatic token refresh)
KOMMO_REFRESH_TOKEN=your-refresh-token
KOMMO_CLIENT_ID=your-client-id
KOMMO_CLIENT_SECRET=your-client-secret

3. Configure MCP Client

Add to your MCP client configuration:

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kommo": {
      "command": "npx",
      "args": ["-y", "kommo-mcp-server"],
      "env": {
        "KOMMO_SUBDOMAIN": "your-subdomain",
        "KOMMO_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Claude Desktop (Windows)

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "kommo": {
      "command": "npx",
      "args": ["-y", "kommo-mcp-server"],
      "env": {
        "KOMMO_SUBDOMAIN": "your-subdomain",
        "KOMMO_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Claude Code CLI

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "kommo": {
      "command": "npx",
      "args": ["-y", "kommo-mcp-server"],
      "env": {
        "KOMMO_SUBDOMAIN": "your-subdomain",
        "KOMMO_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Available Tools

Account

• get_account - Get account information and settings

Leads

• list_leads - List leads with filtering and pagination
• get_lead - Get a specific lead by ID
• create_lead - Create a new lead
• update_lead - Update an existing lead
• create_lead_complex - Create lead with contact and company in one request

Contacts

• list_contacts - List contacts with filtering
• get_contact - Get a specific contact
• create_contact - Create a new contact
• update_contact - Update an existing contact

Companies

• list_companies - List companies
• get_company - Get a specific company
• create_company - Create a new company
• update_company - Update an existing company

Tasks

• list_tasks - List tasks with filtering
• get_task - Get a specific task
• create_task - Create a new task
• complete_task - Mark a task as completed

Pipelines

• list_pipelines - List all pipelines and statuses
• get_pipeline - Get a specific pipeline

Users

• list_users - List all users
• get_user - Get a specific user

Notes

• list_notes - List notes for an entity
• create_note - Add a note to an entity

Other

• list_custom_fields - List custom fields for an entity type
• list_tags - List tags for an entity type
• search - Global search across entities
• list_webhooks - List webhook subscriptions
• create_webhook - Create a webhook
• delete_webhook - Delete a webhook

Usage Examples

Once configured, you can ask Claude to interact with your Kommo CRM:

List Leads

"List my open leads in the Sales pipeline"

Create a Lead

"Create a new lead called 'Acme Corp Deal' with a value of $50,000 in the Main pipeline"

Search Contacts

"Find all contacts with 'john' in their name"

Create a Task

"Create a follow-up call task for lead ID 12345, due tomorrow at 2pm"

Complex Lead Creation

"Create a new lead for 'Big Company Project' worth $100,000, with a contact named John Smith ([email protected], +1-555-0123) and company 'Big Company Inc'"

API Reference

This MCP server wraps the Kommo REST API v4. For detailed information about available fields and options, refer to the official documentation.

Rate Limits

Kommo API has rate limits. The server handles 429 responses automatically by waiting and retrying. For high-volume operations, consider implementing batch processing.

Token Refresh

If you provide KOMMO_REFRESH_TOKEN, KOMMO_CLIENT_ID, and KOMMO_CLIENT_SECRET, the server will automatically refresh expired access tokens.

Development

Building

npm run build

Development Mode

npm run dev

Testing

# Set environment variables first
export KOMMO_SUBDOMAIN=your-subdomain
export KOMMO_ACCESS_TOKEN=your-token

npm run dev

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

MIT License - see LICENSE file for details.

Author

Luiz Otavio Goncalves GitHub

Acknowledgments

• Kommo for their CRM platform and API
• Anthropic for the MCP protocol and Claude
• The MCP community for tools and inspiration