> For the complete documentation index, see [llms.txt](https://docs.allmcp.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allmcp.co/documentation/providers/kommo.md).
# Kommo
Kommo is the international sales-pipeline CRM on `*.kommo.com` — the 2022 global rebrand of amoCRM. AllMCP gives your agent 91 tools covering leads, contacts, companies, tasks, pipelines, and more.
All providersHow connecting works
{% hint style="warning" icon="arrows-split-up-and-left" %}
**Kommo vs amoCRM — not interchangeable.** Kommo (`*.kommo.com`) and amoCRM (`*.amocrm.ru`) share the same API but run on separate platforms with separate logins and data. If your account is on `*.amocrm.ru`, use the [amoCRM provider](/documentation/providers/amocrm.md) instead. Credentials are **not** interchangeable.
{% endhint %}
***
## Connect
{% tabs %}
{% tab title="OAuth2 (recommended)" %}
Ask your agent to connect Kommo. It hands you a secure Kommo sign-in link — open it, approve access, and you're connected. AllMCP handles the consent flow and keeps your access token refreshed for you, so you never have to reconnect manually.
{% endtab %}
{% tab title="Long-lived token (alternative)" %}
Prefer to connect with a token instead of the sign-in flow? Generate one in Kommo, then ask your agent to connect Kommo with it.
{% stepper %}
{% step %}
#### Generate a token
In Kommo, go to `https://{subdomain}.kommo.com/settings/integrations/` → **Create integration** → **Long-lived token**.
{% endstep %}
{% step %}
#### Connect with the token
Ask your agent to connect Kommo and provide:
* **`subdomain`** — your bare Kommo subdomain, without `.kommo.com` (e.g. `your-company`)
* **`access_token`** — the long-lived token you just generated
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}
***
## Tools by category
Kommo shares the same tool surface as amoCRM, with `kommo_`-prefixed tool names. The categories below cover everything your agent can do in Kommo. You can always ask your agent what a category offers before it acts.
### Leads
| Tool | Description |
| --------------------------- | --------------------------------------------------------------------------- |
| `kommo_list_leads` | List leads, optionally filtered by stage, status, or other criteria. |
| `kommo_get_lead` | Get a single lead by its ID. |
| `kommo_create_lead` | Create a new lead. |
| `kommo_create_lead_complex` | Create a lead together with its contacts, companies, and tasks in one step. |
| `kommo_update_lead` | Update a lead's fields or move it to a different pipeline stage. |
| `kommo_link_lead` | Link a lead to a contact or company. |
| `kommo_tag_lead` | Add tags to a lead. |
### Contacts
| Tool | Description |
| ---------------------- | ------------------------------- |
| `kommo_list_contacts` | List contacts in your account. |
| `kommo_get_contact` | Get a single contact by its ID. |
| `kommo_create_contact` | Create a new contact. |
| `kommo_update_contact` | Update a contact's fields. |
### Companies
| Tool | Description |
| ---------------------- | ------------------------------- |
| `kommo_list_companies` | List companies in your account. |
| `kommo_get_company` | Get a single company by its ID. |
| `kommo_create_company` | Create a new company. |
| `kommo_update_company` | Update a company's fields. |
### More categories
Your agent can also work with these areas of Kommo:
| Category | What it covers |
| ----------------- | ---------------------------------------------------------------------------- |
| **Tasks** | Create, update, and complete tasks, set due dates, and assign them to users. |
| **Notes** | Add free-form notes to leads, contacts, and companies. |
| **Pipelines** | Read your pipeline and stage configuration. |
| **Customers** | Manage loyalty and repeat-purchase customer records. |
| **Catalogs** | Work with custom record types such as products and SKUs. |
| **Custom fields** | Read custom field definitions and metadata. |
| **Users** | Look up workspace members and their roles. |
| **Unsorted** | Review and accept or decline incoming leads from forms, chats, and calls. |
| **Comms** | Work with calls, talks, events, and webhook subscriptions. |
***
## Common workflows
Just tell your agent what you want in plain language — for example:
{% tabs %}
{% tab title="Pipeline review" %}
```
Show me all open leads in the "Proposal" stage
```
{% endtab %}
{% tab title="Create a lead with full context" %}
```
Create a lead "Website redesign" for contact John Smith, assign to user ID 5, add it to the "New business" pipeline
```
{% endtab %}
{% tab title="Unsorted inbox" %}
```
List all unsorted incoming leads from today and accept the ones from the website form
```
{% endtab %}
{% endtabs %}
***
## See also
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.allmcp.co/documentation/providers/kommo.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.