How santosadvo/kommo-mcp-publico works
This repository provides a local MCP server that lets Claude Code read and write Kommo CRM data. The principal workflow is Claude tool dispatch through domain-specific tools, the shared authenticated HTTP client, and Kommo’s API; results return through the tool call. Separate setup paths support long-lived tokens and OAuth. The README documents broad CRM capabilities, while the excerpts show their implementation as endpoint calls in server.py. The graph groups those tools by domain rather than implying a sequence between them.
Main entry points: server.py MCP server · kommo_client.py HTTP client · token_longo.py Long-token setup · auth.py OAuth setup
Components 13
MCP access
- MCP server
server.py - HTTP client
kommo_client.py
CRM tools
- Account metadata
server.py - Lead tools
server.py - Contact tools
server.py - Company tools
server.py - Task tools
server.py - Note tools
server.py - Generic API tool
server.py
Credentials
- Long-token setup
token_longo.py - OAuth setup
auth.py
Other components
- Claude Code
- Kommo API v4
Connections 18
- Claude Code → MCP server: uses locally
README.md - MCP server → Account metadata: dispatches tools
server.py - MCP server → Lead tools: dispatches tools
server.py - MCP server → Contact tools: dispatches tools
server.py - MCP server → Company tools: dispatches tools
server.py - MCP server → Task tools: dispatches tools
server.py - MCP server → Note tools: dispatches tools
server.py - MCP server → Generic API tool: dispatches tools
server.py - Account metadata → HTTP client: requests data
server.py - Lead tools → HTTP client: requests data
server.py - Contact tools → HTTP client: requests data
server.py - Company tools → HTTP client: requests data
server.py - Task tools → HTTP client: requests data
server.py - Note tools → HTTP client: requests data
server.py - Generic API tool → HTTP client: sends request
server.py - HTTP client → Kommo API v4: calls API
kommo_client.py - Long-token setup → HTTP client: tests connection
token_longo.py - OAuth setup → Kommo API v4: exchanges code
auth.py