Imported from mcp-dir/kommo-mcp (skills/kommo-mcp/SKILL.md). Install upstream with npx skills add mcp-dir/kommo-mcp --skill kommo-mcp. Copyright stays with the author.

name: kommo-mcp description: Skill da REST API do Kommo na MCP.AI: 42 endpoints em /api/kommo. Kommo CRM (ex-amoCRM), o CRM de vendas por conversa (WhatsApp, Instagram, Telegram) usado por PMEs e agências. Leia e escreva leads, contatos, empresas, tarefas, notas, funis, tags, campos personalizados, usuários, eventos, conversas e catálogos pela API v4 oficial. Você informa o subdomínio da sua conta e um Token de Longa Duração e a plataforma opera na sua conta. Inclui uma ferramenta de chamada crua para qualquer endpoint da API. Autentique com workspace API key (sk_live) gerada em app.mcp.ai/settings/api-keys. Use quando o usuário pedir algo coberto pelos endpoints.

Kommo — REST API skill

Você tem acesso à Kommo REST API na MCP.AI.

Kommo CRM (ex-amoCRM), o CRM de vendas por conversa (WhatsApp, Instagram, Telegram) usado por PMEs e agências. Leia e escreva leads, contatos, empresas, tarefas, notas, funis, tags, campos personalizados, usuários, eventos, conversas e catálogos pela API v4 oficial. Você informa o subdomínio da sua conta e um Token de Longa Duração e a plataforma opera na sua conta. Inclui uma ferramenta de chamada crua para qualquer endpoint da API.

Base URL

https://api.mcp.ai/api/kommo

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/kommo/account \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/kommo/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (42)

`kommo_account`

Dados da conta Kommo conectada (id, nome, subdomínio, moeda, fuso, e opcionalmente usuários/campos/pipelines via with). (POST /api/kommo/account)

Parâmetro	Tipo	Obrigatório	Descrição
`with`	string	Não	Blocos extras separados por vírgula (ex.: "users,pipelines,task_types,custom_fields,amojo_id").
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.

`kommo_catalogs_elements`

Catálogos (listas: produtos, etc.). (POST /api/kommo/catalogs/elements)

Parâmetro	Tipo	Obrigatório	Descrição
`catalog_id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`catalog_ids`	integer	string[]	Não

`kommo_catalogs_list`

Catálogos (listas: produtos, etc.). (POST /api/kommo/catalogs/list)

Parâmetro	Tipo	Obrigatório	Descrição
`catalog_id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`catalog_ids`	integer	string[]	Não

`kommo_companies_create`

Companies do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em data), update (atualiza; com id = 1 item, sem id = bulk com array em data). (POST /api/kommo/companies/create)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"ACME Ltda","custom_fields_values":[{"field_code":"EMAIL","values":[{"value":"contato@acme.com"}]}]}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_companies_get`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"ACME Ltda","custom_fields_values":[{"field_code":"EMAIL","values":[{"value":"contato@acme.com"}]}]}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_companies_list`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"ACME Ltda","custom_fields_values":[{"field_code":"EMAIL","values":[{"value":"contato@acme.com"}]}]}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_companies_update`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"ACME Ltda","custom_fields_values":[{"field_code":"EMAIL","values":[{"value":"contato@acme.com"}]}]}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_contacts_create`

Contacts do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em data), update (atualiza; com id = 1 item, sem id = bulk com array em data). (POST /api/kommo/contacts/create)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Maria","custom_fields_values":[{"field_code":"PHONE","values":[{"value":"+5511999998888"}]}]}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_contacts_get`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Maria","custom_fields_values":[{"field_code":"PHONE","values":[{"value":"+5511999998888"}]}]}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_contacts_list`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Maria","custom_fields_values":[{"field_code":"PHONE","values":[{"value":"+5511999998888"}]}]}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_contacts_update`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Maria","custom_fields_values":[{"field_code":"PHONE","values":[{"value":"+5511999998888"}]}]}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_custom_fields`

Campos personalizados de um tipo de entidade (leads/contacts/companies/customers). (POST /api/kommo/custom/fields)

Parâmetro	Tipo	Obrigatório	Descrição
`entity_type`	string	Sim	Tipo de entidade: "leads", "contacts", "companies" ou "customers". (leads, contacts, companies, customers)
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.

`kommo_customers_create`

Clientes (módulo de vendas recorrentes/RFM do Kommo). (POST /api/kommo/customers/create)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Cliente recorrente","next_price":9900,"next_date":1690000000}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_customers_get`

Clientes (módulo de vendas recorrentes/RFM do Kommo). (POST /api/kommo/customers/get)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Cliente recorrente","next_price":9900,"next_date":1690000000}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_customers_list`

Clientes (módulo de vendas recorrentes/RFM do Kommo). (POST /api/kommo/customers/list)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Cliente recorrente","next_price":9900,"next_date":1690000000}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_customers_update`

Clientes (módulo de vendas recorrentes/RFM do Kommo). (POST /api/kommo/customers/update)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Cliente recorrente","next_price":9900,"next_date":1690000000}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_events`

Eventos/atividades da conta (mudança de estágio, criação, etc.). (POST /api/kommo/events)

Parâmetro	Tipo	Obrigatório	Descrição
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.

`kommo_leads_create`

Leads do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em data), update (atualiza; com id = 1 item, sem id = bulk com array em data). (POST /api/kommo/leads/create)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Lead site","price":2500,"pipeline_id":123,"status_id":456,"_embedded":{"tags":[{"name":"quente"}]}}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_leads_get`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Lead site","price":2500,"pipeline_id":123,"status_id":456,"_embedded":{"tags":[{"name":"quente"}]}}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_leads_list`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Lead site","price":2500,"pipeline_id":123,"status_id":456,"_embedded":{"tags":[{"name":"quente"}]}}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_leads_update`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"name":"Lead site","price":2500,"pipeline_id":123,"status_id":456,"_embedded":{"tags":[{"name":"quente"}]}}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_links_link`

Vínculos entre entidades (ex.: ligar um contato a um lead). (POST /api/kommo/links/link)

Parâmetro	Tipo	Obrigatório	Descrição
`entity_type`	string	Sim	Tipo de entidade: "leads", "contacts", "companies" ou "customers". (leads, contacts, companies, customers)
`entity_id`	integer	string	Sim
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`data`	string	Não	Vínculo(s) como JSON. Ex.: [{"to_entity_id":456,"to_entity_type":"contacts"}].
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`entity_ids`	integer	string[]	Não

`kommo_links_list`

Vínculos entre entidades (ex.: ligar um contato a um lead). (POST /api/kommo/links/list)

Parâmetro	Tipo	Obrigatório	Descrição
`entity_type`	string	Sim	Tipo de entidade: "leads", "contacts", "companies" ou "customers". (leads, contacts, companies, customers)
`entity_id`	integer	string	Sim
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`data`	string	Não	Vínculo(s) como JSON. Ex.: [{"to_entity_id":456,"to_entity_type":"contacts"}].
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`entity_ids`	integer	string[]	Não

`kommo_links_unlink`

Vínculos entre entidades (ex.: ligar um contato a um lead). (POST /api/kommo/links/unlink)

Parâmetro	Tipo	Obrigatório	Descrição
`entity_type`	string	Sim	Tipo de entidade: "leads", "contacts", "companies" ou "customers". (leads, contacts, companies, customers)
`entity_id`	integer	string	Sim
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`data`	string	Não	Vínculo(s) como JSON. Ex.: [{"to_entity_id":456,"to_entity_type":"contacts"}].
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`entity_ids`	integer	string[]	Não

`kommo_list_accounts`

Lista as contas Kommo conectadas a este install (id/subdomínio, label). (POST /api/kommo/list/accounts)

Parâmetro	Tipo	Obrigatório	Descrição
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.

`kommo_notes_create`

Notas de uma entidade. action: list (todas as notas do tipo de entidade), list_by_entity (notas de 1 registro), create (adiciona nota; data = JSON). Tipos comuns: common, call_in, call_out, sms_in/o (POST /api/kommo/notes/create)

Parâmetro	Tipo	Obrigatório	Descrição
`entity_type`	string	Sim	Tipo de entidade: "leads", "contacts", "companies" ou "customers". (leads, contacts, companies, customers)
`entity_id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo da nota como JSON. Ex.: {"note_type":"common","params":{"text":"Comentário"}}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`entity_ids`	integer	string[]	Não

`kommo_notes_list`

Parâmetro	Tipo	Obrigatório	Descrição
`entity_type`	string	Sim	Tipo de entidade: "leads", "contacts", "companies" ou "customers". (leads, contacts, companies, customers)
`entity_id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo da nota como JSON. Ex.: {"note_type":"common","params":{"text":"Comentário"}}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`entity_ids`	integer	string[]	Não

`kommo_notes_list_by_entity`

Parâmetro	Tipo	Obrigatório	Descrição
`entity_type`	string	Sim	Tipo de entidade: "leads", "contacts", "companies" ou "customers". (leads, contacts, companies, customers)
`entity_id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo da nota como JSON. Ex.: {"note_type":"common","params":{"text":"Comentário"}}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`entity_ids`	integer	string[]	Não

`kommo_pipelines_get`

Funis (pipelines) e seus estágios. (POST /api/kommo/pipelines/get)

Parâmetro	Tipo	Obrigatório	Descrição
`pipeline_id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`pipeline_ids`	integer	string[]	Não

`kommo_pipelines_list`

Funis (pipelines) e seus estágios. (POST /api/kommo/pipelines/list)

Parâmetro	Tipo	Obrigatório	Descrição
`pipeline_id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`pipeline_ids`	integer	string[]	Não

`kommo_pipelines_statuses`

Funis (pipelines) e seus estágios. (POST /api/kommo/pipelines/statuses)

Parâmetro	Tipo	Obrigatório	Descrição
`pipeline_id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`pipeline_ids`	integer	string[]	Não

`kommo_request`

Chamada crua à API v4 do Kommo — qualquer endpoint, com o seu token. (POST /api/kommo/request)

Parâmetro	Tipo	Obrigatório	Descrição
`method`	string	Sim	Método HTTP. (GET, POST, PATCH, DELETE)
`path`	string	Sim	Caminho relativo da API v4 (ex.: "/leads", "/leads/unsorted", "/salesbot", "/sources"). O prefixo /api/v4 é adicionado se faltar.
`query_params`	string	Não	Query string como JSON. Ex.: {"limit":50,"filter":{"pipeline_id":[123]}}.
`body`	string	Não	Corpo como JSON (objeto ou array), para POST/PATCH.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.

`kommo_tags_create`

Tags de um tipo de entidade. action: list (com busca) | create (cria tags; data = JSON, ex.: [{"name":"vip"}]). (POST /api/kommo/tags/create)

Parâmetro	Tipo	Obrigatório	Descrição
`entity_type`	string	Sim	Tipo de entidade: "leads", "contacts", "companies" ou "customers". (leads, contacts, companies, customers)
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`data`	string	Não	Tags como JSON (array). Ex.: [{"name":"vip"},{"name":"parceiro"}].
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.

`kommo_tags_list`

Tags de um tipo de entidade. action: list (com busca) | create (cria tags; data = JSON, ex.: [{"name":"vip"}]). (POST /api/kommo/tags/list)

Parâmetro	Tipo	Obrigatório	Descrição
`entity_type`	string	Sim	Tipo de entidade: "leads", "contacts", "companies" ou "customers". (leads, contacts, companies, customers)
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`data`	string	Não	Tags como JSON (array). Ex.: [{"name":"vip"},{"name":"parceiro"}].
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.

`kommo_talks_get`

Conversas (talks) do inbox unificado. (POST /api/kommo/talks/get)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`filter`	string	Não	Filtro JSON. Ex.: {"contact_id":[123]} ou {"only_in_work":""}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_talks_list`

Conversas (talks) do inbox unificado. (POST /api/kommo/talks/list)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`filter`	string	Não	Filtro JSON. Ex.: {"contact_id":[123]} ou {"only_in_work":""}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_tasks_create`

Tasks do Kommo. action: list (busca paginada com filtros), get (por id), create (cria, body em data), update (atualiza; com id = 1 item, sem id = bulk com array em data). (POST /api/kommo/tasks/create)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"text":"Ligar para o lead","complete_till":1690000000,"entity_id":123,"entity_type":"leads"}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_tasks_get`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"text":"Ligar para o lead","complete_till":1690000000,"entity_id":123,"entity_type":"leads"}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_tasks_list`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"text":"Ligar para o lead","complete_till":1690000000,"entity_id":123,"entity_type":"leads"}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_tasks_update`

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`query`	string	Não	Busca textual livre nos campos da entidade.
`with`	string	Não	Entidades relacionadas a incluir, separadas por vírgula (ex.: "contacts,catalog_elements,loss_reason").
`filter`	string	Não	Filtros como JSON. Ex.: {"responsible_user_id":[123],"created_at":{"from":1690000000}} (timestamps Unix).
`order`	string	Não	Ordenação como JSON. Ex.: {"updated_at":"desc"} ou {"id":"asc"}.
`data`	string	Não	Corpo de create/update como JSON (objeto ou array). Ex.: {"text":"Ligar para o lead","complete_till":1690000000,"entity_id":123,"entity_type":"leads"}.
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_users_get`

Usuários da conta. action: list | get (por id). with=role,group para incluir permissões/grupos. (POST /api/kommo/users/get)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`with`	string	Não	Extras separados por vírgula (ex.: "role,group").
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

`kommo_users_list`

Usuários da conta. action: list | get (por id). with=role,group para incluir permissões/grupos. (POST /api/kommo/users/list)

Parâmetro	Tipo	Obrigatório	Descrição
`id`	integer	string	Não
`page`	integer	Não	Página da listagem (default 1).
`limit`	integer	Não	Itens por página (máx 250, cap do servidor).
`with`	string	Não	Extras separados por vírgula (ex.: "role,group").
`account`	string	Não	Quando há múltiplas contas Kommo conectadas: id/subdomínio/label da conexão. Veja kommo_list_accounts.
`ids`	integer	string[]	Não

Este MCP também funciona via conexão MCP (Claude / Cursor) em https://api.mcp.ai/p_kommo — veja o README. A skill acima é pra consumir a REST API direto (agente próprio / código).

About

Kommo — REST API skill

Base URL

Autenticação

Formato de resposta

Exemplo cURL

Reportar problemas

Endpoints (42)

kommo_account

kommo_catalogs_elements

kommo_catalogs_list

kommo_companies_create

kommo_companies_get

kommo_companies_list

kommo_companies_update

kommo_contacts_create

kommo_contacts_get

kommo_contacts_list

kommo_contacts_update

kommo_custom_fields

kommo_customers_create

kommo_customers_get

kommo_customers_list

kommo_customers_update

kommo_events

kommo_leads_create

kommo_leads_get

kommo_leads_list

kommo_leads_update

kommo_links_link

kommo_links_list

kommo_links_unlink

kommo_list_accounts

kommo_notes_create

kommo_notes_list

kommo_notes_list_by_entity

kommo_pipelines_get

kommo_pipelines_list

kommo_pipelines_statuses

kommo_request

kommo_tags_create

kommo_tags_list

kommo_talks_get

kommo_talks_list

kommo_tasks_create

kommo_tasks_get

kommo_tasks_list

kommo_tasks_update

kommo_users_get

kommo_users_list

Use it

Manifest

Reviews