amoCRM MCP Server

MCP (Model Context Protocol) server for amoCRM integration with Claude Desktop and other AI assistants.

Features

• Leads -- list, get, create, update

• Contacts -- list, get, create

• Companies -- list, get, create

• Tasks -- list, create

• Pipelines -- list pipelines and stages

• Users -- list account users

• Notes -- add and read notes on any entity

• Account -- get account info

Related MCP server: Bitrix24 MCP Server

Prerequisites

• Python 3.10+

• amoCRM account with API access

• Long-lived token from amoCRM integration settings

Installation

git clone https://github.com/DocAtWork2026/amocrm-mcp.git
cd amocrm-mcp
pip install -r requirements.txt

Configuration

1. Copy .env.example to .env and fill in your credentials:

cp .env.example .env

AMOCRM_DOMAIN=your_subdomain
AMOCRM_TOKEN=your_long_lived_token

• AMOCRM_DOMAIN -- your amoCRM subdomain (e.g. if your URL is https://mycompany.amocrm.ru, the domain is mycompany)

• AMOCRM_TOKEN -- long-lived API token from your amoCRM integration settings

Getting the token

1. Go to amoCRM Settings -> amoMarket

2. Click the three dots menu -> Create integration

3. Choose "External integration", set name and redirect URI (https://localhost)

4. Save, then install the integration

5. Open the integration -> "Keys and access" tab

6. Click "Generate token" under "Long-lived token"

7. Copy the token

Claude Desktop Setup

Add this to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "amocrm": {
      "command": "python",
      "args": ["C:/path/to/amocrm-mcp/server.py"],
      "env": {
        "AMOCRM_DOMAIN": "your_subdomain",
        "AMOCRM_TOKEN": "your_long_lived_token"
      }
    }
  }
}

Restart Claude Desktop after updating the config.

Available Tools

License

MIT