kommo-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KOMMO_TOKEN | Yes | Your long-lived Kommo API token | |
| KOMMO_SUBDOMAIN | Yes | The subdomain of your Kommo account (the part before .kommo.com) |
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 | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kommo_accountA | Dados da conta Kommo (id, nome, subdomínio, moeda, fuso). Use para confirmar conexão. |
| kommo_pipelinesA | Lista todos os funis e suas etapas (id, nome, ordem). Use para descobrir pipeline_id/status_id antes de criar ou mover leads. |
| kommo_usersA | Lista usuários (id, nome, email). Use para mapear nome -> responsible_user_id ao trocar responsáveis. |
| kommo_custom_fieldsA | Lista campos personalizados de uma entidade (leads/contacts/companies). Use para achar field_id (ex.: campos 'N8N | ...' de tracking). |
| kommo_search_leadsA | Busca leads. Filtra por texto (query), funil, etapa e responsável. Retorna leads com contatos embutidos. |
| kommo_get_leadB | Detalhe completo de um lead por id, com contatos. Use note_limit>0 para anexar as últimas notas. |
| kommo_create_leadC | Cria um lead. Opcionalmente já vincula um contato (nome + telefone) e seta campos custom. |
| kommo_update_leadC | Atualiza um lead: mover de etapa/funil (status_id/pipeline_id), preço, responsável, nome ou campos custom. |
| kommo_change_responsibleB | Troca o responsável de um ou vários leads de uma vez (operação em lote). |
| kommo_add_noteC | Adiciona uma nota de texto a um lead (ou contato/empresa). |
| kommo_create_taskB | Cria uma tarefa vinculada a um lead (ou outra entidade), com prazo e responsável. |
| kommo_complete_taskC | Marca uma tarefa como concluída, opcionalmente com texto de resultado. |
| kommo_list_tasksB | Lista tarefas. Filtra por responsável, entidade e status (concluída ou não). |
| kommo_get_eventsA | Feed de eventos (auditoria). Essencial para ENTENDER BOTS: quem mudou o quê, quando. Filtre created_by=0 para ações de bot/automação nativa. Tipos comuns: lead_status_changed, entity_responsible_changed, lead_added, incoming_chat_message. |
| kommo_search_contactsB | Busca contatos por texto (nome, telefone, email). |
| kommo_create_statusC | Cria uma nova ETAPA dentro de um funil (desenvolver etapas). Informe pipeline_id, name e opcionalmente sort/color. |
| kommo_update_statusB | Renomeia/reordena/recolore uma etapa existente. |
| kommo_create_contactC | Cria um contato. Telefone/email viram custom fields PHONE/EMAIL automaticamente. |
| kommo_update_contactB | Atualiza um contato existente (nome, responsável, campos custom). |
| kommo_search_companiesC | Busca empresas por texto (nome, etc.). |
| kommo_create_companyC | Cria uma empresa. |
| kommo_update_companyC | Atualiza uma empresa existente. |
| kommo_linkC | Vincula uma entidade a outra (ex.: contato↔lead, empresa↔lead/contato). |
| kommo_list_webhooksA | Lista os webhooks configurados na conta (destino e eventos assinados). |
| kommo_subscribe_webhookB | Assina um webhook: envia eventos da Kommo para uma URL. settings = lista de eventos (ex.: add_lead, status_lead, update_lead, add_contact, add_task). |
| kommo_delete_webhookB | Remove (cancela) um webhook pela URL de destino. |
| kommo_create_custom_fieldB | Cria um campo personalizado numa entidade. type: text, numeric, select, multiselect, date, url, checkbox, textarea, etc. Para select/multiselect, passe enums. |
| kommo_update_custom_fieldC | Atualiza um campo personalizado (renomear, etc.). |
| kommo_requestA | Passthrough genérico autenticado da API v4 da Kommo, para qualquer coisa não coberta pelas tools acima. path relativo (ex.: '/companies'). Cuidado: PATCH/POST/DELETE alteram dados. |
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 29 tools
Each tool has a clear and distinct purpose, targeting specific entities (leads, contacts, companies, tasks, webhooks, custom fields, pipelines, statuses, users, events) and actions (create, update, get, search, list, delete/subscribe). There is no ambiguity between tools; even similar verbs (e.g., create vs update) are well separated by entity.
The naming convention is predominantly 'kommo_verb_noun' in English (e.g., create_lead, search_companies, list_tasks). However, two tools break the pattern: 'kommo_link' (should be something like link_entity) and 'kommo_pipelines' (should be list_pipelines). These minor inconsistencies slightly reduce consistency.
29 tools is on the higher side but appropriate for a comprehensive CRM integration covering leads, contacts, companies, tasks, webhooks, custom fields, pipelines, statuses, users, and events. The count reflects necessary CRUD operations plus search and administrative tools. No obvious bloat.
The tool set covers most expected CRM operations: CRUD for leads, contacts, companies, custom fields, statuses; task management; webhook subscription; user listing; and event tracking. Notable gaps include missing delete operations for leads, contacts, companies, and tasks, but these can be addressed via the generic API passthrough ('kommo_request'). Overall, the surface is nearly complete.