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:
- Install
- Create the integration
- Sign in with a key
- Sign in through the integration
- Which one to choose
- Connect step by step
- Sign out and revoke access
- 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 doctorAn 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):
- Open амоМаркет, click ⋯ at the top left and choose «Создать интеграцию».
- Give it a name and a description, such as WireCat.
- 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. - Under «Предоставить доступ», tick «Доступ к данным аккаунта».
- 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.
-
In the integration, open the «Ключи» tab (Kommo: Keys and scopes) and click «Сгенерировать токен» (Kommo: Generate long-lived token).
-
Pick an end date, from one day to five years.
-
Copy the token. It is shown only once (amoCRM: step by step, Kommo: long-lived token).
-
Choose a profile name for this account, such as
work. Run the commands below with your account's address in place of the examplehttps://example.amocrm.ru, and paste the token whenamoasks: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.
-
On the integration's «Ключи» tab (Kommo: Keys and scopes), copy the integration ID. Keep the secret key open too.
-
Run the command below with your own address and integration ID in place of the examples
https://example.amocrm.ruand0123abcd-4567-89ef-0123-456789abcdef:amo work session start --host https://example.amocrm.ru --client-id 0123abcd-4567-89ef-0123-456789abcdef -
Paste the secret key when
amoasks. It is not shown.AMO_AMOCRM_CLIENT_SECRETcan give it instead. -
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 startagain. - 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
amogets a new one each time it renews the access token. So it keeps working whileamoruns 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:
- Which account? The address you open the CRM at.
- Create a private integration. The steps of create the integration.
- Make the token. Paste the key from the «Ключи» tab.
- Checking the token.
amoasks 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. - 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:openMore in the first sync.