Kommo CRM

Name: Kommo CRM
Author: depper-ia

@depper-iaMCP server · External

Manage Kommo CRM leads, contacts, pipelines, tasks, notes, tags and companies.

CRMv1.0.5MITPython

Freeno charge per call

How to install

Runs on your machine from its package; the steps are below.

What it does

Reads
Writes
High impact

At most: moves money, runs code or commands, deletes data, or sends messages for you.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

PyPIkommo-kiro-powerv1.0.5

Run

uvx kommo-kiro-power

MCP client config

{
  "mcpServers": {
    "kommo-crm": {
      "command": "uvx",
      "args": [
        "kommo-kiro-power"
      ]
    }
  }
}

README3 min readView on GitHub

kommo-kiro-power — Kommo CRM Power for Kiro

Connect AI agents to your Kommo CRM (formerly amoCRM) using the Model Context Protocol. Manage leads, contacts, pipelines, tasks, notes, tags, and companies — all from natural language in Kiro or any MCP-compatible client.

Features

Category	Tools
Leads	list, get, create, update, delete, move stage, bulk update
Contacts	list, get, create, update
Pipelines	list, create, update
Stages	list, create, update
Tags	list, add, remove (auto-creates if needed)
Tasks	create, list (with overdue filter)
Notes	add note to lead
Chat	list templates, send message
Companies	create, list
Custom Fields	list, create (text, select, multiselect, date, etc.)
Advanced	create lead + contact + company in one call

Quick Start

Install as Kiro Power

Open Kiro → Powers panel → Add Custom Power
Select Import power from GitHub
Paste: https://github.com/depper-IA/kommo-kiro-power
Follow the onboarding steps when activated

Install as standalone MCP

Published on PyPI and the official MCP Registry. With uv installed, no clone is needed:

bash

uvx --from kommo-kiro-power kommo-mcp

Or install the one-click MCPB bundle (kommo-crm.mcpb) in Claude Desktop or any MCPB-compatible client. Bundle sources live in mcpb/. After changing tools, run python scripts/build_mcpb.py to sync the manifest, then pnpm dlx @anthropic-ai/mcpb pack mcpb kommo-crm.mcpb. For Smithery, python scripts/build_mcpb.py --smithery kommo-crm-smithery.mcpb builds a variant that also carries each tool's inputSchema.

Or from source:

bash

git clone https://github.com/depper-IA/kommo-kiro-power.git
cd kommo-kiro-power
pip install -e .

Setup

1. Create a Kommo Integration

Go to Kommo → Settings → Integrations → Create integration
Copy the Client ID and Client Secret
Set http://localhost:8080/callback as the Redirect URI

2. Configure Credentials

bash

cp .env.example .env
# Edit .env with your Kommo integration details

3. Authenticate (OAuth)

bash

python scripts/oauth_setup.py

A browser opens → sign in to Kommo → authorize → tokens saved automatically.

4. Run the MCP Server

bash

python -m kommo_mcp
# or
kommo-mcp

Usage with Kiro

Once installed as a Power, the server activates automatically when you mention keywords like "kommo", "leads", "pipeline", "crm", or "contacts" in your conversation.

"Show me all leads in the Sales pipeline"
"Create a lead for Maria from TechCorp with phone +57 310 543 6281"
"Move lead 12345 to the Negotiation stage"
"List all overdue tasks"

Usage with Other MCP Clients

Add to your claude_desktop_config.json, opencode.json, or equivalent:

json

{
  "mcpServers": {
    "kommo": {
      "command": "uvx",
      "args": ["--from", "kommo-kiro-power", "kommo-mcp"],
      "env": {
        "KOMMO_SUBDOMAIN": "your_subdomain",
        "KOMMO_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

Architecture

kommo-kiro-power/
├── plugin.json           # Kiro Power manifest (Agent Plugins format)
├── POWER.md              # Legacy Kiro Power metadata + onboarding
├── mcp.json              # MCP server config for Kiro
├── server.json           # Official MCP Registry metadata
├── skills/               # Workflow guides loaded on-demand
│   ├── leads-workflow/SKILL.md
│   ├── pipeline-management/SKILL.md
│   └── automation-patterns/SKILL.md
├── kommo_mcp/            # Python MCP server
│   ├── __main__.py       # Entry point (stdio transport)
│   ├── mcp_server.py     # Server + tool registration
│   ├── kommo_client.py   # HTTP client (OAuth, retry, cache)
│   └── tools/            # Tool definitions + handlers
│       ├── leads.py
│       ├── contacts.py
│       └── pipelines.py
├── scripts/
│   └── oauth_setup.py    # One-time OAuth authentication
├── pyproject.toml        # Package config
└── requirements.txt

Security

Credentials read from .env — never hardcoded
.env is in .gitignore — never committed
OAuth v4 with automatic token refresh
Rate limiting: max 5 requests/second
Exponential backoff with jitter on failures
Response caching for pipelines/stages/fields (10 min TTL)

Compatibility

Python: 3.10, 3.11, 3.12, 3.13
MCP Clients: Kiro, Claude Desktop, OpenCode, Cursor, Codex
Kommo API: v4

Privacy

The server runs locally on your machine and talks only to your own Kommo account API. It has no telemetry and sends no data to the author or any third party. See PRIVACY.md.

Support

Bugs and feature requests: GitHub Issues
Email: sam@wilkiedevs.com

License

MIT

Similar modules

Browse CRM