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

Quick Start

Install as Kiro Power

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

Install as standalone MCP

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

Setup

1. Create a Kommo Integration

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

2. Configure Credentials

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

3. Authenticate (OAuth)

python scripts/oauth_setup.py

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

4. Run the MCP Server

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:

{
  "mcpServers": {
    "kommo": {
      "command": "python",
      "args": ["-m", "kommo_mcp"]
    }
  }
}

Architecture

kommo-kiro-power/
├── POWER.md              # Kiro Power metadata + onboarding
├── mcp.json              # MCP server config for Kiro
├── steering/             # Workflow guides loaded on-demand
│   ├── leads-workflow.md
│   ├── pipeline-management.md
│   └── automation-patterns.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

License

MIT