amoCRM MCP Server

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

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

| Tool | Description | |------|-------------| | get_account_info | Get amoCRM account info | | get_leads | List leads (with search) | | get_lead | Get lead details by ID | | create_lead | Create a new lead | | update_lead | Update an existing lead | | get_contacts | List contacts (with search) | | get_contact | Get contact details by ID | | create_contact | Create a new contact | | get_companies | List companies (with search) | | get_company | Get company details by ID | | create_company | Create a new company | | get_tasks | List tasks | | create_task | Create a new task | | get_pipelines | List pipelines and stages | | get_users | List account users | | add_note | Add a note to an entity | | get_notes | Get notes for an entity |

License

MIT