Skip to main content
Glama
Sign In
deenesjakoptruzh
Kommo CRM MCP Server

Kommo CRM MCP Server

by clarkstamina-max
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Kommo CRM MCP Server

Centralized MCP (Model Context Protocol) server for the Stamina Digital agency. Serves multiple clients (multi-tenancy) via VPS environment variables.

How to configure the team's AI

The way to connect the server depends on which interface your team uses:

Option 1: Antigravity (Local)

If you are using Antigravity, you don't need to configure files manually. Just send the following message in the chat to the AI:

"Install this MCP server for me: https://kommo-mcp.stamina.digital/sse"

The AI itself will change its configuration file and connect automatically to the VPS. You'll know it worked when it confirms.

Option 2: Claude Web

  1. Go to the Customize menu.

  2. Click Connectors.

  3. Select Add -> Add custom connector.

  4. Paste only the clean URL of our server: https://kommo-mcp.stamina.digital/sse

Related MCP server: GHL MCP Server

How to add new clients (Admins only)

All security and routing are managed on the VPS (Easypanel). No token is saved on the team's PC. The AI dynamically discovers which client to access based on the client_slug.

  1. Access Easypanel.

  2. Go to the Environment tab of this project.

  3. Add the new client's domain and token using the pattern KOMMO_<SLUG>_DOMAIN and KOMMO_<SLUG>_TOKEN. (Note: Always use UPPERCASE letters to create the variable, without spaces).

Practical example for the client "Casa Despertar":

KOMMO_CASA_DESPERTAR_DOMAIN=jorge3mktdigitalcombr.kommo.com
KOMMO_CASA_DESPERTAR_TOKEN=eyJhbGci...

(The slug generated for the AI will be: casa_despertar)

  1. Save the variables and click Deploy.

  2. Done! You don't need to tell the team to configure anything. From that second on, they can ask the AI: "See the overdue tasks from casa_despertar".

Available Tools

63 tools
add_noteA

Adiciona uma nota/observação de texto (common note) na linha do tempo de um Lead, Contato ou Empresa.

Inputs: text (required), entity_id (required), client_slug (required), entity_type.

add_usersB

Adiciona novos usuários à conta do Kommo.

Inputs: users (required), client_slug (required).

complete_taskB

Marca uma tarefa como concluída e, opcionalmente, adiciona um resultado/observação.

Inputs: task_id (required), client_slug (required), result_text (required).

create_catalog_elementsA

Cria novos elementos (ex: produtos) em lote dentro de um catálogo específico.

Inputs: elements (required), catalog_id (required), client_slug (required).

create_companyB

Cria uma nova empresa no CRM.

Inputs: name (required), client_slug (required), custom_fields_values.

create_complex_leadA

Cria um lead de forma 'complexa', permitindo anexar imediatamente contatos, empresas, tags, etc. Tudo em uma só requisição e suportando regras de controle de duplicados.

Inputs: client_slug (required), name, price, _embedded, +3 more.

create_contactB

Cria um novo contato no Kommo CRM.

Inputs: first_name (required), client_slug (required), last_name, custom_fields_values.

create_custom_fieldB

Cria um novo campo customizado para uma entidade (ex: leads). Tipos: text, numeric, checkbox, select, date, etc.

Inputs: name (required), client_slug (required), type, group_id, +1 more.

create_custom_field_groupC

Cria um novo grupo de campos (aba/seção) na entidade.

Inputs: name (required), client_slug (required), sort, entity_type.

create_leadC

Cria um novo lead no Kommo CRM.

Inputs: name (required), client_slug (required), price, _embedded, +3 more.

create_pipelineC

Cria um novo funil de vendas (pipeline) no CRM.

Inputs: name (required), client_slug (required), sort, is_main.

create_pipeline_stageB

Cria uma nova etapa (status) dentro de um funil de vendas existente.

Inputs: name (required), client_slug (required), pipeline_id (required), sort, +1 more.

create_taskA

Cria uma nova tarefa no CRM (ex: ligar, reunião, email). Complete_till deve ser um Timestamp UNIX.

Inputs: text (required), client_slug (required), complete_till (required), entity_id, +3 more.

create_templateC

Cria um novo modelo de chat (template). Para WhatsApp, o type costuma ser 'waba'.

Inputs: name (required), content (required), client_slug (required), type, +3 more.

create_webhookA

Inscreve um novo webhook. A Kommo enviará POST requests para o destination_url quando os eventos especificados ocorrerem.

Inputs: settings (required), client_slug (required), destination (required).

delete_custom_fieldB

Exclui um campo customizado existente.

Inputs: id (required), client_slug (required), entity_type.

delete_custom_field_groupC

Exclui um grupo de campos.

Inputs: id (required), client_slug (required), entity_type.

delete_pipelineC

Exclui um funil de vendas inteiro.

Inputs: client_slug (required), pipeline_id (required).

delete_pipeline_stageB

Exclui uma etapa específica de um funil.

Inputs: status_id (required), client_slug (required), pipeline_id (required).

delete_templateA

Exclui um modelo de chat. IMPORTANTE: Limitação da API da Kommo: Você só pode excluir modelos criados pela integração atual (ou seja, via API usando este mesmo token).

Inputs: id (required), client_slug (required).

delete_webhookA

Remove um webhook existente. Para remover, você deve passar exatamente a mesma URL (destination) que foi cadastrada.

Inputs: client_slug (required), destination (required).

get_available_clientsA

Busca a lista de todos os clientes (slugs) configurados e disponíveis neste servidor MCP da agência.

Inputs: no named parameters.

get_catalog_by_idA

Retorna as configurações e campos (custom_fields) de um catálogo específico.

Inputs: catalog_id (required), client_slug (required).

get_catalog_elementsC

Retorna a lista de itens/produtos (elements) que estão salvos dentro de um catálogo. Possui campo de busca textual.

Inputs: catalog_id (required), client_slug (required), page, limit, +1 more.

get_catalogsA

Retorna a lista de todos os catálogos (Lists) configurados na conta. Muito útil para descobrir o ID de listas de Produtos.

Inputs: client_slug (required), page, limit.

get_companiesC

Busca uma lista de empresas cadastradas no CRM.

Inputs: client_slug (required), page, limit, query.

get_contactsC

Busca uma lista de contatos no Kommo CRM.

Inputs: client_slug (required), page, limit, query.

get_conversationsB

Busca a lista de conversas (Talks) na Kommo. Você pode filtrar por contact_id para ver os chats de um cliente específico.

Inputs: client_slug (required), page, limit, entity_id, +2 more.

get_custom_field_by_idC

Busca detalhes de um campo customizado específico usando o ID.

Inputs: id (required), client_slug (required), entity_type.

get_custom_field_group_by_idB

Obtém detalhes de um grupo de campos de entidade por ID.

Inputs: id (required), client_slug (required), entity_type.

get_custom_field_groupsB

Lista os grupos de campos (abas/seções) de uma entidade.

Inputs: client_slug (required), entity_type.

get_custom_fieldsA

Busca a estrutura de campos customizados da conta (ex: descobrir o ID do campo 'CPF' ou 'Origem' para preencher um Lead/Contato).

Inputs: client_slug (required), entity_type.

get_event_by_idA

Busca detalhes de um evento específico usando o ID.

Inputs: id (required), client_slug (required).

get_eventsA

Busca a lista de eventos (histórico/timeline) da conta. Útil para consultar detalhadamente o que aconteceu com um lead (mudanças de etapa, anotações, tarefas).

Inputs: client_slug (required), page, limit, filter_type, +2 more.

get_event_typesA

Busca todos os tipos de eventos disponíveis no sistema (ex: lead_added, task_completed).

Inputs: client_slug (required).

get_lead_by_idA

Busca os detalhes de um lead específico usando o ID.

Inputs: id (required), client_slug (required), with.

get_leadsA

Busca uma lista de leads no Kommo CRM. Permite paginação e busca por termo.

Inputs: client_slug (required), page, limit, query.

get_notesA

Busca as notas de um Lead, Contato ou Empresa específico. Útil para o LLM ler o histórico ou resumos anteriores.

Inputs: entity_id (required), client_slug (required), page, limit, +1 more.

get_pipeline_by_idA

Busca os detalhes de um funil específico usando o ID (inclui etapas).

Inputs: client_slug (required), pipeline_id (required).

get_pipelinesA

Busca a lista de todos os funis de vendas (pipelines) da conta Kommo.

Inputs: client_slug (required).

get_role_by_idA

Retorna as permissões exatas de um perfil de acesso (Role) específico pelo seu ID.

Inputs: role_id (required), client_slug (required).

get_rolesA

Retorna todos os perfis de acesso (Roles) da conta. Use para descobrir qual o 'role_id' de um 'Gerente' ou 'Vendedor'.

Inputs: client_slug (required).

get_salesbot_by_idA

Busca os detalhes de um Salesbot específico usando o ID.

Inputs: id (required), client_slug (required).

get_salesbotsC

Busca a lista de Salesbots configurados na conta Kommo.

Inputs: client_slug (required), page, limit.

get_tagsA

Busca as tags (etiquetas) existentes na conta para uma entidade.

Inputs: client_slug (required), entity_type.

get_tasksB

Busca uma lista de tarefas na Kommo CRM. Pode filtrar por lead (entity_type=leads), se está concluída, etc.

Inputs: client_slug (required), page, limit, entity_id, +2 more.

get_templatesC

Busca a lista de modelos de chat (templates), como mensagens de WhatsApp aprovadas (waba).

Inputs: client_slug (required), page, limit.

get_user_by_idA

Retorna os detalhes de um usuário específico pelo seu ID (ex: email, nome, role_id).

Inputs: user_id (required), client_slug (required).

get_usersA

Retorna a lista de usuários configurados na conta. Útil para encontrar IDs de responsáveis por leads (responsible_user_id).

Inputs: client_slug (required), page, limit.

get_webhooksC

Lista os webhooks configurados na conta Kommo.

Inputs: client_slug (required), page, limit.

launch_salesbotA

Inicia um Salesbot (robô) para um Lead ou Contato específico.

Inputs: bot_id (required), entity_id (required), client_slug (required), entity_type (required).

link_entitiesB

Vincula duas entidades. Exemplo clássico: vincular um Contato (to_entity_type='contacts') a um Lead (from_entity_type='leads').

Inputs: client_slug (required), to_entity_id (required), from_entity_id (required), to_entity_type (required), +1 more.

stop_salesbotD

Para a execução de um Salesbot para uma entidade específica.

Inputs: bot_id (required), entity_id (required), client_slug (required), entity_type.

update_catalog_elementsB

Atualiza elementos (ex: produtos) em lote dentro de um catálogo específico.

Inputs: elements (required), catalog_id (required), client_slug (required).

update_companyC

Atualiza uma empresa existente.

Inputs: id (required), client_slug (required), name, custom_fields_values.

update_contactC

Atualiza um contato existente.

Inputs: id (required), client_slug (required), last_name, first_name, +1 more.

update_custom_fieldC

Atualiza um campo customizado existente.

Inputs: id (required), client_slug (required), name, group_id, +1 more.

update_custom_field_groupB

Atualiza um grupo de campos (aba/seção) existente.

Inputs: id (required), client_slug (required), name, sort, +1 more.

update_leadA

Atualiza um lead existente no Kommo CRM. Muito usado para mover o lead de funil ou etapa, adicionar tags ou atualizar campos.

Inputs: id (required), client_slug (required), name, price, +4 more.

update_pipelineB

Atualiza o nome ou propriedades de um funil existente.

Inputs: id (required), client_slug (required), name, sort, +1 more.

update_pipeline_stageC

Atualiza o nome ou a cor de uma etapa de um funil.

Inputs: status_id (required), client_slug (required), pipeline_id (required), name, +2 more.

update_taskB

Atualiza os detalhes de uma tarefa existente (texto, data, responsável).

Inputs: id (required), client_slug (required), text, complete_till, +1 more.

update_templateA

Atualiza um modelo de chat existente. IMPORTANTE: Limitação da API da Kommo: Você só pode atualizar modelos criados pela integração atual (ou seja, via API usando este mesmo token).

Inputs: id (required), client_slug (required), name, content.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    C2.7/5.0

    Scored across 63 tools

    Disambiguation4/5

    Tools are mostly grouped by entity with distinct actions (list, get, create, update, delete), and overlapping tools like create_lead vs create_complex_lead are sufficiently differentiated by description. A few pairs such as get_catalogs and get_catalog_elements could cause slight hesitation, but overall boundaries are clear.

    Naming Consistency4/5

    The vast majority follow a consistent verb_noun snake_case pattern (get_*, create_*, update_*, delete_*). Minor deviations like add_note, add_users, get_available_clients, and launch_salesbot/stop_salesbot prevent a perfect score but do not create real confusion.

    Tool Count2/5

    63 tools is far beyond the comfortable MCP range and will likely bloat agent context and slow tool selection. The broad Kommo CRM domain justifies many operations, but the surface should be curated or split into smaller focused servers to remain practical.

    Completeness3/5

    The toolset covers a wide range of CRM entities and admin features, but there are notable gaps: no get_contact_by_id or get_company_by_id, and no delete operations for leads, contacts, companies, tasks, or notes. These are workable gaps but not a fully complete lifecycle.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • N8N MCP Server

      rajtrafficradius
      A
      license
      Not graded
      quality
      D
      maintenance
      Production-ready MCP server that brings N8N workflow automation to both Claude.ai and ChatGPT. Supports multi-tenant OAuth/SSE integration with dynamic N8N instance configuration.
      128 npm
      MIT

    • GHL MCP Server

      northrosetech
      A
      license
      B
      quality
      D
      maintenance
      A comprehensive MCP server that connects AI assistants to GoHighLevel CRM, enabling management of contacts, conversations, calendars, pipelines, payments, and more through 60+ tools.
      64
      40 npm
      1
      MIT

    • kommo-mcp

      RonaldoESantosRevOps
      A
      license
      B
      quality
      D
      maintenance
      Self-hosted MCP server that connects AI assistants to Kommo CRM (API v4), enabling real-time CRM actions such as creating/managing leads, tasks, notes, and more through 29 tools.
      29
      1
      MIT