1. Conduid
  2. Blockchain
  3. io.github.theYahia/amocrm-mcp
MCP server · Blockchain

io.github.theYahia/amocrm-mcp

by · github.com/theYahia/amocrm-mcp

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

Unclaimed blockchain
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.theYahia/amocrm-mcp

io.github.theYahia/amocrm-mcp is an MCP server published by theYahia in the Blockchain category: mCP server for amoCRM API — leads, contacts, pipelines. Auth: Bearer token.

Recent commit activity is the strongest signal that reported issues will get attention.

Install

Claude Code
claude mcp add io-github-theyahia-amocrm-mcp -- npx -y @theyahia/amocrm-mcp
npx
npx -y @theyahia/amocrm-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (19)

accept_unsortedAccept an unsorted lead — moves it into a pipeline as a real lead. Optionally specify target pipeline, status, and responsible user.

Parameters not published.

add_noteAdd a note to a lead, contact, or company. Supports common notes, incoming/outgoing call logs, and service messages.

Parameters not published.

complete_taskMark a task as completed and add a result text. The result will appear in the entity

Parameters not published.

create_companyCreate a new company in amoCRM. Use custom_fields_values for address, website, etc.

Parameters not published.

create_contactCreate a new contact in amoCRM. Use custom_fields_values to set phone, email, and other fields.

Parameters not published.

create_leadCreate a new lead (deal) in amoCRM. Requires a name. Optionally set price, pipeline, status, responsible user, and custom fields.

Parameters not published.

create_taskCreate a task linked to a lead, contact, or company. Set deadline (complete_till as Unix timestamp) and task type (1=Call, 2=Meeting, 3=Email).

Parameters not published.

get_accountGet current amoCRM account info — name, plan, users, task types, etc. Use

Parameters not published.

get_contactGet a single contact by ID with full details including custom fields (phone, email, etc.).

Parameters not published.

get_leadGet a single lead by ID with full details. Use

Parameters not published.

Show all 19 tools
list_companiesSearch and list companies in amoCRM. Use

Parameters not published.

list_contactsSearch and list contacts in amoCRM. Supports full-text search across name, phone, and email.

Parameters not published.

list_eventsList events (activity log) in amoCRM. Filter by entity type, entity ID, or event type. Shows status changes, calls, notes, and other activities.

Parameters not published.

list_leadsSearch and list deals (leads) in amoCRM. Supports filtering by pipeline, statuses, and full-text search. Use

Parameters not published.

list_pipelinesList all sales pipelines with their statuses (stages). Essential for understanding the sales funnel structure before creating or filtering leads.

Parameters not published.

list_tasksList tasks in amoCRM. Filter by entity (lead/contact/company), completion status, or responsible user.

Parameters not published.

list_unsortedList incoming unsorted leads (from forms, email parsing, etc.) that need to be accepted or declined.

Parameters not published.

searchUniversal search across amoCRM — finds leads, contacts, and companies matching the query. Min 3 characters.

Parameters not published.

update_leadUpdate an existing lead — change name, price, status, pipeline, responsible user, or custom fields. Useful for moving deals between stages.

Parameters not published.

Ask AI

✦

Ask AI about io.github.theYahia/amocrm-mcp

Powered by Claude · Grounded in docs

I know everything about io.github.theYahia/amocrm-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

@theyahia/amocrm-mcp

Production-grade MCP server for amoCRM API. 19 tools covering leads, contacts, companies, pipelines, tasks, notes, search, events, and unsorted leads. OAuth 2.0 with automatic token refresh. Rate limiting (7 req/sec). Retry with exponential backoff.

Installation

npx -y @theyahia/amocrm-mcp

MCP Configuration

Add to your Claude Desktop, Cursor, or any MCP client config:

{
  "mcpServers": {
    "amocrm": {
      "command": "npx",
      "args": ["-y", "@theyahia/amocrm-mcp"],
      "env": {
        "AMOCRM_SUBDOMAIN": "mycompany",
        "AMOCRM_ACCESS_TOKEN": "your-access-token",
        "AMOCRM_REFRESH_TOKEN": "your-refresh-token",
        "AMOCRM_CLIENT_ID": "your-client-id",
        "AMOCRM_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Environment Variables

Variable Required Description
AMOCRM_SUBDOMAIN Yes Your amoCRM subdomain (e.g. mycompany from mycompany.amocrm.ru)
AMOCRM_ACCESS_TOKEN Yes OAuth access token
AMOCRM_REFRESH_TOKEN No OAuth refresh token (enables auto-refresh on 401)
AMOCRM_CLIENT_ID No OAuth client ID (required for token refresh)
AMOCRM_CLIENT_SECRET No OAuth client secret (required for token refresh)

AMOCRM_DOMAIN is also accepted as an alias for AMOCRM_SUBDOMAIN (backwards compatibility).

Tools (19)

Leads

Tool Description
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.

Contacts

Tool Description
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.

Companies

Tool Description
list_companies Search companies. Embed linked leads and contacts.
create_company Create a company with custom fields.

Pipelines

Tool Description
list_pipelines List all sales pipelines with their statuses (stages).

Tasks

Tool Description
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.

Unsorted

Tool Description
list_unsorted List incoming unsorted leads (forms, email parsing).
accept_unsorted Accept an unsorted lead into a pipeline.

Notes

Tool Description
add_note Add a note (common, call_in, call_out, service_message) to any entity.

Search

Tool Description
search Universal search across leads, contacts, and companies.

Events

Tool Description
list_events Activity log — status changes, calls, notes, links.

Account

Tool Description
get_account Account info, users, task types, amojo settings.

Demo Prompts

Sales overview:

"Show me all leads in the 'Sales' pipeline that are currently in the 'Negotiation' stage. Include contact info."

Task management:

"Create a follow-up call task for lead #12345, deadline tomorrow at 10:00 AM. Then list all my incomplete tasks."

New client onboarding:

"Create a contact 'Ivan Petrov' with phone +79001234567, then create a company 'Petrov Solutions' and a lead 'Website Development' for 150,000 RUB in the main pipeline."

OAuth 2.0 Setup Guide

  1. Go to your amoCRM account settings: https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/
  2. Create a new integration (external integration)
  3. Set the redirect URI to https://YOUR_SUBDOMAIN.amocrm.ru
  4. Copy the Client ID and Client Secret
  5. Authorize the integration to get the initial Authorization Code
  6. Exchange the code for tokens:
curl -X POST https://YOUR_SUBDOMAIN.amocrm.ru/oauth2/access_token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "authorization_code",
    "code": "YOUR_AUTH_CODE",
    "redirect_uri": "https://YOUR_SUBDOMAIN.amocrm.ru"
  }'
  1. Save the access_token and refresh_token from the response
  2. The server will automatically refresh expired tokens if AMOCRM_REFRESH_TOKEN, AMOCRM_CLIENT_ID, and AMOCRM_CLIENT_SECRET are set

Error Handling

  • 401 Unauthorized: Auto-refreshes token if refresh credentials are configured, then retries
  • 429 Rate Limited: Respects Retry-After header, waits and retries
  • 5xx Server Errors: Exponential backoff retry (up to 3 attempts)
  • Rate Limiting: Built-in 150ms delay between requests (~7 req/sec) to stay within amoCRM limits

Development

git clone https://github.com/theYahia/amocrm-mcp.git
cd amocrm-mcp
npm install
npm run build
npm test

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.theYahia/amocrm-mcp

How do I install io.github.theYahia/amocrm-mcp?

Run claude mcp add io-github-theyahia-amocrm-mcp -- npx -y @theyahia/amocrm-mcp, then add the server to your MCP client's configuration.

Is io.github.theYahia/amocrm-mcp safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.theYahia/amocrm-mcp still maintained?

Yes — the last commit was a month ago. The repository has 0 stars and 0 forks.