> 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/amocrm.md).

# amoCRM

amoCRM is the dominant sales-pipeline CRM in Russia and CIS markets (`*.amocrm.ru`). AllMCP gives your AI agent 91 tools spanning the full sales pipeline: leads, contacts, companies, tasks, notes, pipelines, and more.

<a href="/pages/QJVxDLqxIz5KMCH5afbE" class="button primary" data-icon="table-cells">All providers</a> <a href="/pages/LCxjCVwlclt0MOQcPwvP" class="button secondary" data-icon="gear">How connecting works</a>

{% hint style="info" %}
amoCRM (`*.amocrm.ru`) and Kommo (`*.kommo.com`) share the same API but run on separate platforms. If your account is on `*.kommo.com`, use the [Kommo provider](/documentation/providers/kommo.md) instead — the credentials are not interchangeable.
{% endhint %}

***

## Connect

Point your MCP client at the AllMCP endpoint with your API key, then ask your agent to connect amoCRM. There are two ways to authenticate.

{% tabs %}
{% tab title="OAuth2 (recommended)" %}
{% stepper %}
{% step %}

#### Ask your agent to connect amoCRM

Your agent starts the connection and gives you a link to authorize AllMCP against your amoCRM account.
{% endstep %}

{% step %}

#### Grant access

Open the link, sign in to amoCRM, and approve access. That's it — AllMCP handles the OAuth consent and keeps your access token refreshed for you, so you never have to reconnect manually.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Long-lived token (alternative)" %}
{% stepper %}
{% step %}

#### Generate a long-lived token

In the amoCRM admin:

1. Go to `https://{subdomain}.amocrm.ru/settings/integrations/`
2. **Create integration** → **Long-lived token**
3. Set validity (up to 5 years)
   {% endstep %}

{% step %}

#### Connect with the token

Ask your agent to connect amoCRM with a long-lived token. You'll need to provide:

* **subdomain** — your bare subdomain, without `.amocrm.ru` (for example, `your-company`)
* **access\_token** — the long-lived token you generated above
  {% endstep %}
  {% endstepper %}
  {% endtab %}
  {% endtabs %}

***

## Tools by category

Once amoCRM is connected, your agent can browse the available tools and call them as needed. The full sales-pipeline toolset is listed below by category.

### Leads

| Tool                         | Description                                                                      |
| ---------------------------- | -------------------------------------------------------------------------------- |
| `amocrm_list_leads`          | List leads, optionally filtered by stage, pipeline, or other criteria.           |
| `amocrm_get_lead`            | Retrieve the full details of a single lead by its ID.                            |
| `amocrm_create_lead`         | Create a new lead in the pipeline.                                               |
| `amocrm_create_lead_complex` | Create a lead together with its contacts, companies, and tasks in a single step. |
| `amocrm_update_lead`         | Update a lead's fields or move it to a different pipeline stage.                 |
| `amocrm_link_lead`           | Link a lead to an existing contact or company.                                   |
| `amocrm_tag_lead`            | Add one or more tags to a lead.                                                  |

### Contacts

| Tool                    | Description                                              |
| ----------------------- | -------------------------------------------------------- |
| `amocrm_list_contacts`  | List contacts in the account.                            |
| `amocrm_get_contact`    | Retrieve the full details of a single contact by its ID. |
| `amocrm_create_contact` | Create a new contact.                                    |
| `amocrm_update_contact` | Update an existing contact's fields.                     |
| `amocrm_link_contact`   | Link a contact to a lead or company.                     |

### Companies

| Tool                    | Description                                              |
| ----------------------- | -------------------------------------------------------- |
| `amocrm_list_companies` | List companies in the account.                           |
| `amocrm_get_company`    | Retrieve the full details of a single company by its ID. |
| `amocrm_create_company` | Create a new company.                                    |
| `amocrm_update_company` | Update an existing company's fields.                     |

### Tasks

| Tool                   | Description                                                               |
| ---------------------- | ------------------------------------------------------------------------- |
| `amocrm_list_tasks`    | List tasks, optionally filtered by owner, due date, or completion status. |
| `amocrm_get_task`      | Retrieve the full details of a single task by its ID.                     |
| `amocrm_create_task`   | Create a new task with a due date and assignee.                           |
| `amocrm_update_task`   | Update a task's text, due date, or assignee.                              |
| `amocrm_complete_task` | Mark a task as complete.                                                  |

### Notes

Add and read free-form notes attached to leads, contacts, and companies.

### Pipelines

Read your pipeline and stage configuration so the agent knows which stages a lead can move through.

### Customers

Work with loyalty and repeat-purchase customer records.

### Catalogs

Read and manage custom record types such as products and SKUs.

### Custom fields

Read the definitions and metadata for your account's custom fields.

### Users

Look up workspace members and their roles.

### Unsorted

Review incoming leads landing in the unsorted inbox from forms, chats, and calls, then accept or decline them.

### Comms

Work with calls, talks, events, and webhook subscriptions.

***

## Common workflows

Describe what you want in plain language and let your agent pick the right tools.

{% tabs %}
{% tab title="Daily lead review" %}

```
List all leads in the "New" stage created today with their source
```

{% endtab %}

{% tab title="Create a complex lead" %}

```
Create a new lead "Renovation contract" for contact Marina Ivanova, link to company "JSM Co", add a task to call back tomorrow
```

{% endtab %}

{% tab title="Pipeline analysis" %}

```
Show me the count of leads per stage in pipeline ID 1
```

{% endtab %}
{% endtabs %}

***

## See also

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-table-cells" style="color:$primary;">:table-cells:</i></h4></td><td><strong>All providers</strong></td><td>Browse every connected provider.</td><td><a href="/pages/QJVxDLqxIz5KMCH5afbE">/pages/QJVxDLqxIz5KMCH5afbE</a></td></tr><tr><td><h4><i class="fa-bolt" style="color:$primary;">:bolt:</i></h4></td><td><strong>System tools</strong></td><td>The five always-on tools every connection ships with.</td><td><a href="https://docs.allmcp.co/documentation/api-reference/system-tools">https://docs.allmcp.co/documentation/api-reference/system-tools</a></td></tr></tbody></table>


---

# 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/amocrm.md?ask=<question>
```

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.