Kommo CRM MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_available_clientsA | Busca a lista de todos os clientes (slugs) configurados e disponíveis neste servidor MCP da agência. |
| get_leadsA | Busca uma lista de leads no Kommo CRM. Permite paginação e busca por termo. |
| get_lead_by_idA | Busca os detalhes de um lead específico usando o ID. |
| create_leadC | Cria um novo lead no Kommo CRM. |
| update_leadA | Atualiza um lead existente no Kommo CRM. Muito usado para mover o lead de funil ou etapa, adicionar tags ou atualizar campos. |
| 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. |
| get_contactsC | Busca uma lista de contatos no Kommo CRM. |
| create_contactB | Cria um novo contato no Kommo CRM. |
| update_contactC | Atualiza um contato existente. |
| get_pipelinesA | Busca a lista de todos os funis de vendas (pipelines) da conta Kommo. |
| get_pipeline_by_idA | Busca os detalhes de um funil específico usando o ID (inclui etapas). |
| create_pipelineC | Cria um novo funil de vendas (pipeline) no CRM. |
| update_pipelineB | Atualiza o nome ou propriedades de um funil existente. |
| delete_pipelineC | Exclui um funil de vendas inteiro. |
| create_pipeline_stageB | Cria uma nova etapa (status) dentro de um funil de vendas existente. |
| update_pipeline_stageC | Atualiza o nome ou a cor de uma etapa de um funil. |
| delete_pipeline_stageB | Exclui uma etapa específica de um funil. |
| get_tasksB | Busca uma lista de tarefas na Kommo CRM. Pode filtrar por lead (entity_type=leads), se está concluída, etc. |
| create_taskA | Cria uma nova tarefa no CRM (ex: ligar, reunião, email). Complete_till deve ser um Timestamp UNIX. |
| complete_taskB | Marca uma tarefa como concluída e, opcionalmente, adiciona um resultado/observação. |
| update_taskB | Atualiza os detalhes de uma tarefa existente (texto, data, responsável). |
| add_noteA | Adiciona uma nota/observação de texto (common note) na linha do tempo de um Lead, Contato ou Empresa. |
| get_notesA | Busca as notas de um Lead, Contato ou Empresa específico. Útil para o LLM ler o histórico ou resumos anteriores. |
| 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. |
| get_companiesC | Busca uma lista de empresas cadastradas no CRM. |
| create_companyB | Cria uma nova empresa no CRM. |
| update_companyC | Atualiza uma empresa existente. |
| link_entitiesB | Vincula duas entidades. Exemplo clássico: vincular um Contato (to_entity_type='contacts') a um Lead (from_entity_type='leads'). |
| 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). |
| get_tagsA | Busca as tags (etiquetas) existentes na conta para uma entidade. |
| create_custom_fieldB | Cria um novo campo customizado para uma entidade (ex: leads). Tipos: text, numeric, checkbox, select, date, etc. |
| get_custom_field_by_idC | Busca detalhes de um campo customizado específico usando o ID. |
| update_custom_fieldC | Atualiza um campo customizado existente. |
| delete_custom_fieldB | Exclui um campo customizado existente. |
| get_custom_field_groupsB | Lista os grupos de campos (abas/seções) de uma entidade. |
| create_custom_field_groupC | Cria um novo grupo de campos (aba/seção) na entidade. |
| get_custom_field_group_by_idB | Obtém detalhes de um grupo de campos de entidade por ID. |
| update_custom_field_groupB | Atualiza um grupo de campos (aba/seção) existente. |
| delete_custom_field_groupC | Exclui um grupo de campos. |
| get_templatesC | Busca a lista de modelos de chat (templates), como mensagens de WhatsApp aprovadas (waba). |
| create_templateC | Cria um novo modelo de chat (template). Para WhatsApp, o type costuma ser 'waba'. |
| 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). |
| 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). |
| get_salesbotsC | Busca a lista de Salesbots configurados na conta Kommo. |
| get_salesbot_by_idA | Busca os detalhes de um Salesbot específico usando o ID. |
| launch_salesbotA | Inicia um Salesbot (robô) para um Lead ou Contato específico. |
| stop_salesbotD | Para a execução de um Salesbot para uma entidade específica. |
| get_webhooksC | Lista os webhooks configurados na conta Kommo. |
| create_webhookA | Inscreve um novo webhook. A Kommo enviará POST requests para o destination_url quando os eventos especificados ocorrerem. |
| delete_webhookA | Remove um webhook existente. Para remover, você deve passar exatamente a mesma URL (destination) que foi cadastrada. |
| 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). |
| get_event_by_idA | Busca detalhes de um evento específico usando o ID. |
| get_event_typesA | Busca todos os tipos de eventos disponíveis no sistema (ex: lead_added, task_completed). |
| get_catalogsA | Retorna a lista de todos os catálogos (Lists) configurados na conta. Muito útil para descobrir o ID de listas de Produtos. |
| get_catalog_by_idA | Retorna as configurações e campos (custom_fields) de um catálogo específico. |
| get_catalog_elementsC | Retorna a lista de itens/produtos (elements) que estão salvos dentro de um catálogo. Possui campo de busca textual. |
| create_catalog_elementsA | Cria novos elementos (ex: produtos) em lote dentro de um catálogo específico. |
| update_catalog_elementsB | Atualiza elementos (ex: produtos) em lote dentro de um catálogo específico. |
| get_usersA | Retorna a lista de usuários configurados na conta. Útil para encontrar IDs de responsáveis por leads (responsible_user_id). |
| get_user_by_idA | Retorna os detalhes de um usuário específico pelo seu ID (ex: email, nome, role_id). |
| add_usersB | Adiciona novos usuários à conta do Kommo. |
| get_rolesA | Retorna todos os perfis de acesso (Roles) da conta. Use para descobrir qual o 'role_id' de um 'Gerente' ou 'Vendedor'. |
| get_role_by_idA | Retorna as permissões exatas de um perfil de acesso (Role) específico pelo seu ID. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 63 tools
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.
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.
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.
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.