Amocrm Mcp

Name: Amocrm Mcp
Author: theYahia

by theYahiacommunityv1.0.1

This MCP server provides a production-grade interface for the amoCRM API, offering 19 tools for managing leads, contacts, companies, tasks, and more.

From the registry: MCP server for amoCRM API — leads, contacts, pipelines. Auth: Bearer token.

GitHub Repository

Install & configure

Prerequisites

required
amoCRM OAuth credentials
Create an integration in amoCRM settings to get client_id/secret, then exchange an auth code for access + refresh tokens
https://www.amocrm.ru/

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `amocrm-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **amoCRM OAuth credentials** — Create an integration in amoCRM settings to get client_id/secret, then exchange an auth code for access + refresh tokens (https://www.amocrm.ru/)

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@theyahia/amocrm-mcp"]
- required environment variables:
  - `AMOCRM_SUBDOMAIN`: amoCRM subdomain (e.g. mycompany) (example: `<your-amocrm-subdomain>`)
  - `AMOCRM_ACCESS_TOKEN`: OAuth access token (example: `<your-amocrm-access-token>`)
- optional environment variables:
  - `AMOCRM_REFRESH_TOKEN`: OAuth refresh token (enables auto-refresh) (example: `<your-amocrm-refresh-token>`)
  - `AMOCRM_CLIENT_ID`: OAuth client ID (required for refresh) (example: `<your-amocrm-client-id>`)
  - `AMOCRM_CLIENT_SECRET`: OAuth client secret (required for refresh) (example: `<your-amocrm-client-secret>`)

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Tools (19)

list_leads

Search and list deals with filters (pipeline, statuses, query). Embed contacts, loss reasons.

get_lead

Get a single lead by ID with linked contacts and catalog elements.

create_lead

Create a new lead with name, price, pipeline, status, custom fields.

update_lead

Update lead fields — move between stages, change price, reassign.

list_contacts

Search contacts by name, phone, email.

get_contact

Get a single contact with all custom fields.

create_contact

Create a contact with phone, email, and custom fields.

list_companies

Search companies. Embed linked leads and contacts.

create_company

Create a company with custom fields.

list_pipelines

List all sales pipelines with their statuses (stages).

list_tasks

List tasks filtered by entity, completion, responsible user.

create_task

Create a task linked to a lead/contact/company with deadline.

complete_task

Mark task as done and add result text.

Environment variables

AMOCRM_SUBDOMAINrequiredYour amoCRM subdomain (e.g. `mycompany` from `mycompany.amocrm.ru`)

AMOCRM_ACCESS_TOKENrequiredOAuth access token

Packages

@theyahia/amocrm-mcp

npmv1.0.1transport: stdio

Details

Language: TypeScript
License: MIT
Released: Mar 31, 2026
Last commit: Apr 1, 2026
Registry name: io.github.theYahia/amocrm-mcp

Related Servers

Xactions

Twitter X automation MCP - post schedule analytics engagement social media

416

Mcp Conta Azul

MCP server for Conta Azul — accounting, invoicing, customers, products

241

Mcp Omie

MCP server for Omie — ERP, customers, products, orders, invoices, financials

241