CRMamoCRM

Install the amoCRM CLI and MCP server

Install the amoCRM CLI with npm, make a private integration and sign in with a token or in the browser.

Connect your amoCRM or Kommo account once, and from then on your AI agent can read and update your deals. The CRM keeps your deals, contacts and companies in the cloud, and it lets a program in only through a private integration that an account administrator makes.

Your agent then answers which deals are open, moves a deal to the next stage or finds a client, from a terminal or over MCP, as far as the permissions you set allow. You run the same commands yourself, or from a script.

amo is a WireCat command-line tool, a program you or your agent run by its name. You connect it once per account, and amo work setup asks each question in turn. One private integration serves both ways of signing in: a token you paste, or a sign-in in the browser. The one prerequisite is an account administrator, who makes the integration.

On this page:

  1. Install
  2. Create the integration
  3. Sign in with a key
  4. Sign in through the integration
  5. Which one to choose
  6. Connect step by step
  7. Sign out and revoke access
  8. Next: the first sync

Install

Install amo once on each computer where you or an agent use it. You need Node.js 22.16 or a later 22.x, or 24 or later. Node 23 is not supported.

npm install -g @wirecat/amo-cli
amo --version
amo skill install   # the agent skill, for Claude Code, Codex, Gemini CLI and OpenClaw
amo doctor

An agent with no terminal, such as Claude Desktop, uses amo over MCP instead. amo doctor needs no network and opens no keyring. It shows the version, where settings live, the profiles that exist, and whether other users of the computer can read the settings.

Create the integration

An account administrator does this once. The same integration serves the key and the browser sign-in.

In amoCRM (<subdomain>.amocrm.ru):

  1. Open амоМаркет, click ⋯ at the top left and choose «Создать интеграцию».
  2. Give it a name and a description, such as WireCat.
  3. In «Ссылка для перенаправления» (the Redirect URI), enter https://wirecat.dev/webhooks/apps/amo-callback. The key does not use it, but with it the same integration also works for the browser sign-in.
  4. Under «Предоставить доступ», tick «Доступ к данным аккаунта».
  5. Leave «Контроль дублей» and «Множественные источники» unticked, and save.

On an account that is not marked technical, amoCRM first asks you to sign a waiver of technical support for a private integration. After that, amoCRM support no longer takes reports of system errors on the account, and the waiver cannot be taken back. Read it before you sign (amoCRM: integrations, amoCRM: step by step).

In Kommo (<subdomain>.kommo.com or <subdomain>.amocrm.com): Settings → Integrations → Create integration. Fill in the name, the description and the same Redirect URL. Allow access has every scope ticked by default. Leave Duplicate control and Multiple sources unticked, and save. Kommo asks for no waiver (Kommo: private integration).

Sign in with a key

The key is amoCRM's long-lived token. It acts with the rights of the administrator who made it.

  1. In the integration, open the «Ключи» tab (Kommo: Keys and scopes) and click «Сгенерировать токен» (Kommo: Generate long-lived token).

  2. Pick an end date, from one day to five years.

  3. Copy the token. It is shown only once (amoCRM: step by step, Kommo: long-lived token).

  4. Choose a profile name for this account, such as work. Run the commands below with your account's address in place of the example https://example.amocrm.ru, and paste the token when amo asks:

    amo work session start --host https://example.amocrm.ru
    amo work session status --check

session start reads the token without showing it, or from stdin. It checks the token against the account, and only then keeps it in the system keyring with the address. --credential-storage file keeps it in a private file instead. session status --check shows the account and the user the token acts as. The address stays as you give it: <subdomain>.amocrm.ru, <subdomain>.kommo.com or <subdomain>.amocrm.com.

Sign in through the integration

This sign-in uses OAuth: you allow the integration in the browser, and each person acts with their own rights.

  1. On the integration's «Ключи» tab (Kommo: Keys and scopes), copy the integration ID. Keep the secret key open too.

  2. Run the command below with your own address and integration ID in place of the examples https://example.amocrm.ru and 0123abcd-4567-89ef-0123-456789abcdef:

    amo work session start --host https://example.amocrm.ru --client-id 0123abcd-4567-89ef-0123-456789abcdef
  3. Paste the secret key when amo asks. It is not shown. AMO_AMOCRM_CLIENT_SECRET can give it instead.

  4. The browser opens amoCRM. Choose the account and click «Разрешить» (Allow).

amo keeps the tokens and renews the access token itself. The integration's Redirect URI must be https://wirecat.dev/webhooks/apps/amo-callback. A new sign-in of either kind replaces the profile's other one.

Which one to choose

  • The key is the simplest: one paste and no browser. It acts as the administrator who made it, and stops on its end date. Then you make a new one and run session start again.
  • The integration sign-in acts as the person who signs in, and has no end date to watch. amoCRM's refresh token lasts 3 months, and amo gets a new one each time it renews the access token. So it keeps working while amo runs at least once in 3 months. After a longer pause, sign in again (amoCRM: step by step).

Connect step by step

amo work setup asks the questions one at a time, checks the answers and saves them only when the check passes:

  1. Which account? The address you open the CRM at.
  2. Create a private integration. The steps of create the integration.
  3. Make the token. Paste the key from the «Ключи» tab.
  4. Checking the token. amo asks the account who the token belongs to, and saves the address and the token only if the account answers. A refused token takes you back to the token step.
  5. Connected. The profile is ready.

It signs in with the key. The browser sign-in is the command shown under Advanced on the last step.

Sign out and revoke access

amo work session end forgets the sign-in on this computer. amo work account remove --keep-data forgets the profile's sign-in and files, and --delete-data also deletes the account's copy from the WireCat store.

Neither tells amoCRM. To stop a key on the account itself, for example after a leak, open the integration's «Выданные доступы» tab and click «Отозвать доступ» (amoCRM: step by step). In Kommo it is the Authorization tab → Revoke access (Kommo: long-lived token).

Next: the first sync

Copy your deals and their clients into WireCat, then list the open ones:

amo work sync
amo work deals list status:open

More in the first sync.