Kommo MCP server

Connect Kommo to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy KommoBook a demo

What you can do with the Kommo MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get contact tool in Kommo
  • Use the update contact tool in Kommo
  • Use the add note tool in Kommo
  • Use the create contact tool in Kommo
  • Use the list contacts tool in Kommo
  • Use the create task tool in Kommo

Supported Tools

get_contact

Get Contact

Retrieve a single contact by its ID. Returns full contact details including name, linked leads, tags, and custom fields.

update_contact

Update Contact

Update an existing contact. Change name, responsible user, tags, or custom field values (phone, email, etc.).

add_note

Add Note

Add a note to a lead, contact, or company. Supports various note types including plain text, call records, SMS, service messages, and geolocation.

create_contact

Create Contact

Create a new contact in Kommo. Set the contact name, assign a responsible user, add tags, set custom field values (e.g., phone, email), and optionally link to a company.

list_contacts

List Contacts

Search and list contacts in Kommo. Supports filtering by search query, responsible user, and contact IDs. Returns contacts with their linked leads, tags, and custom fields.

create_task

Create Task

Create a new task in Kommo. Tasks can be linked to leads, contacts, or companies. Set the task description, deadline, type (follow-up or meeting), duration, and responsible user.

get_company

Get Company

Retrieve a single company by its ID. Returns full company details including name, linked contacts, tags, and custom fields.

list_notes

List Notes

List notes attached to a lead, contact, or company. Returns notes with their type, content, and metadata.

list_custom_fields

List Custom Fields

List custom fields for leads, contacts, or companies. Returns field definitions including type, available options for select fields, and field IDs needed for setting custom field values on entities.

list_pipelines

List Pipelines

List all sales pipelines and their stages. Each pipeline contains ordered stages that represent steps in the sales process. Use this to discover available pipelines and stage IDs for creating or moving leads.

update_lead

Update Lead

Update an existing lead. Change its name, price, pipeline stage, responsible user, tags, custom fields, or loss reason. Use this to move leads between pipeline stages or mark them as won/lost.

list_leads

List Leads

Search and list sales leads in Kommo. Supports filtering by search query, pipeline, responsible user, and lead IDs. Returns leads with their pipeline stage, price, tags, and custom fields.

manage_tags

Manage Tags

List existing tags or create new tags for leads, contacts, or companies. Tags are entity-type specific. Use **action** "list" to see all tags, or "create" to add new ones.

get_lead

Get Lead

Retrieve a single lead by its ID. Returns full lead details including pipeline stage, price, contacts, tags, custom fields, and loss reason.

list_companies

List Companies

Search and list companies in Kommo. Supports filtering by search query, responsible user, and company IDs. Returns companies with tags and custom fields.

get_account

Get Account

Get Kommo account information including account name, subdomain, current user, currency, and configured task types and user groups.

create_company

Create Company

Create a new company in Kommo. Set the company name, assign a responsible user, add tags, and set custom field values.

create_lead

Create Lead

Create a new sales lead in Kommo. Optionally link it to a pipeline/stage, assign a responsible user, set a price, add tags, and set custom field values. Can link an existing contact and company to the new lead.

list_users

List Users

List account users or get a specific user by ID. Returns user details including name, email, role, and admin status. Requires an administrator account. Use this to find user IDs for assigning leads, contacts, or tasks.

update_task

Update Task

Update an existing task. Change its text, deadline, responsible user, or mark it as completed with an optional result message.

manage_entity_links

Manage Entity Links

List, create, or remove links between entities. Link leads to contacts, contacts to companies, leads to catalog items, etc. Use **action** "list" to see existing links, "link" to create new links, or "unlink" to remove them.

list_tasks

List Tasks

Search and list tasks in Kommo. Filter by completion status, responsible user, linked entity, or task IDs. Returns tasks with their deadlines, linked entities, and completion status.

update_company

Update Company

Update an existing company. Change name, responsible user, tags, or custom field values.

list_events

List Events

List events (audit log) from the Kommo account. Filter by entity type, entity ID, event types, or time range. Tracks all changes across leads, contacts, companies, and more.

manage_incoming_lead

Manage Incoming Lead

Accept an incoming lead into the sales pipeline or decline it. Call list_incoming_leads first to discover its UID. Declining removes it from the incoming queue.

list_incoming_leads

List Incoming Leads

List incoming leads awaiting processing. Discover their UIDs, sources, pipeline, and linked CRM records before accepting or declining them with manage_incoming_lead.

get_task

Get Task

Get a task by ID, including its deadline, responsible user, linked entity, completion state, and result.

list_loss_reasons

List Loss Reasons

List the account’s lead loss reasons. Returns IDs and names to use with update_lead when closing a lead as lost.

Connect Kommo to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Kommo in Metorial. In your Metorial portal, enable the Kommo MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Kommo tools.

Run Kommo through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Kommo and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Kommo tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Kommo

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Technical notes for Kommo

Manage sales leads, contacts, companies, and pipelines in a messenger-based CRM. Create, read, update, and delete leads with pipeline stage tracking, loss reasons, and duplicate control. Manage contacts and companies with custom fields, tags, and entity linking. Create and organize sales pipelines with customizable stages. Handle tasks with deadlines and assignments linked to CRM entities. Send and receive messages through connected chat channels (WhatsApp, Telegram, etc.), manage conversation history, and track delivery status. Process incoming/unsorted leads from web forms and other sources — accept, decline, or link them. Upload and attach files to entities. Manage users, roles, and permissions. Create message templates including WhatsApp templates. Launch and control Salesbot automations for automated chat responses. Add AI knowledge sources and import products for AI features. Log calls and handle VoIP notifications.

Frequently asked questions

Common questions about connecting Kommo to AI agents with Metorial.

  1. How many tools does the Kommo MCP server have?
    The Kommo MCP server exposes 28 tools, including Get Contact, Update Contact, Add Note. Each one is governed and traced through Metorial.
  2. Kommo exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Kommo MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Kommo and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Kommo MCP server yourself or use the hosted gateway.

Connect Kommo to production AI agents

See how Metorial gives your team governed access to Kommo, with tracing and security controls built in.

Book a demoDeploy Kommo