Artificial intelligence

MCP connector for Kommo

Connects Claude, ChatGPT, Cursor, Gemini, Grok and other AI to Kommo. The AI reads and updates leads, contacts, companies, tasks and notes.

Features

Read, update and delete leads, contacts and companies
Tasks, notes, custom fields, tags and catalogs
Connect Claude, ChatGPT, Cursor, Gemini and other AI

Installation and setup guide

Detailed guide for working with widget "MCP connector for Kommo"

CONTENTS

  1. About the widget
  2. Release connection data
  3. Setting up the AI client
  4. Access check
  5. Important nuances
  6. Frequently asked questions and solutions
  7. Functions
    1. Leads, contacts, companies and buyers
    2. Hooks
    3. Tasks and notes
    4. Pipelines, tags and custom fields
    5. Directories and connections
    6. Users
    7. Events
    8. Mail
    9. Messages in a lead
    10. Files, bot and notifications
    11. Wishlist
  8. Chats
    1. Claude
    2. ChatGPT
    3. Gemini
    4. Grok
    5. Perplexity
    6. Mistral
  9. Editors
    1. Cursor
    2. VS Code
    3. JetBrains
    4. Zed
    5. Windsurf
    6. Cline
  10. Agents and automation
    1. Claude Code
    2. Codex
    3. Gemini CLI
    4. Qwen Code
    5. OpenCode
    6. Kiro
    7. GitHub Copilot CLI
    8. Warp
    9. Goose
    10. LM Studio
    11. Raycast
    12. Copilot Studio
    13. n8n
    14. Open WebUI

About the widget

The widget creates a secure MCP server so that external AI clients (Claude, ChatGPT, Cursor, Gemini and others) can securely request data from your Kommo.

Release connection data

In the widget settings, the profile has an MCP address. It is inserted into the AI client.

Create a profile in the widget settings. The profile will have an MCP address. It is enough: the login takes place via OAuth when the client opens this address.

MCP connector settings: server address

MCP profile address

Each profile has its own address. For Kommo it is on sp1-nova.ru, for Kommo - on sp1-nova.com. Copy it from the settings, do not assemble it manually.

Setting up the AI client

Insert the MCP address into the AI client settings and go through OAuth.

Paste the MCP address into your AI client settings. The process is slightly different depending on the service:

  • Claude: Settings → Connectors → Add custom connector. Paste the server address and leave the published identity as Claude. Give permission to access Kommo data.
  • ChatGPT: in MCP settings, create a custom MCP server and paste the address.
  • Cursor: Add the server to the mcp.json file and provide the address.
  • Gemini: Insert the address as instructed by your MCP host.

After pasting the address, the client will open authorization (OAuth) and request permission to access Kommo data. For detailed steps for different clients, see the Chats, Editors, and Agents and Automation sections below.

Access check

After authorization, check that the AI client sees the available tools (functions). The widget provides a set of actions: searching for leads and contacts, uploading statistics on pipelines, reading correspondence history, generating summaries. Make sure all the necessary tools are active.

Sometimes, after widget updates, access marks may be reset - periodically check that all tools have a permission (for example, “Always allow”).

Important nuances

  • Access mode. By default, the widget provides read-only access (search, analytics, reports). AI does not automatically perform direct recording (creating, editing, deleting records in CRM). If you need recording capabilities, enable the appropriate methods in the widget settings.
  • Safety. The profile address is issued individually. Deleting a profile revokes access.
  • Data structure. If your account uses custom fields (for example, the lead source is stored not in a standard field, but in a separate one), indicate this in the widget settings. This way the AI agent will correctly understand the structure of your data.

Frequently asked questions and solutions

  • Error during authorization. Check that the entire address has been copied and that the widget is active in Kommo.
  • AI doesn't see tools. Make sure that the widget settings for these tools are set to Always allow.
  • Data is not updated. Check the expiration date of the OAuth token—if necessary, the widget should automatically renew it.

If any difficulties arise at any stage, write to support - we will help you figure it out!

Functions

AI calls functions itself. Lists of leads, contacts, companies, customers, and the event feed can be filtered. Lists return up to 250 records per page, the default is 50. You cannot delete a Pipeline or create a user with these functions. If some functionality is missing, AI launches a wishlist. A bug or error is sent via bug_report.

Lists of leads, contacts, companies, customers, and the event feed can be filtered. A lead can be filtered by name, pipeline and stage, created, closed and next-task dates, source, unsorted category, owner, creator, editor, tasks, budget, labor cost, loss reason, tags, products, conversations, main contact, company, and custom fields. A contact or company can be filtered by name, created and updated dates, pipelines of linked leads, including records without leads, owner, author, tasks, tags, and fields. A customer can also be filtered by the next purchase date and amount, status, LTV, number of purchases, and average check. An event can be filtered by date, author, type, and the value before and after. A contact phone and email are still found by the search string.

Leads, contacts, companies and buyers

FunctionWhat it does
leads_listLead list. Can be filtered by stage, date, owner, fields, and other list conditions
leads_getOne lead by id
leads_createCreate leads
leads_updateUpdate leads
leads_deleteDelete leads by id
contacts_listContact list. Can be filtered by date, linked leads, owner, and fields
contacts_getOne contact by id
contacts_createCreate contacts
contacts_updateUpdate contacts
contacts_deleteDelete contacts by id
companies_listCompany list. Can be filtered by date, linked leads, owner, and fields
companies_getOne company by id
companies_createCreate companies
companies_updateUpdate companies
companies_deleteDelete companies by id
customers_listCustomer list. Can be filtered by purchase date, status, amount, and fields
customers_getOne customer by id
customers_createCreate customers
customers_updateUpdate customers
customers_deleteDelete customers by id
customers_enableEnable the Customers section. Mode: segments or periodicity
invoices_enableEnable Invoices/purchases. A second list is not created
invoices_listInvoices of a lead or customer, one page
invoices_getInvoice by id, including the payment link
invoices_createCreate an invoice and attach it to a lead or customer

Hooks

You can attach a Grok routine to the hook address: for example, to a new incoming message (add_message) or a new lead (add_lead). Other AI providers have the same technique - routine, automation or webhook, which accept HTTP POST. amo can't add a title. webhooks_add_bearer registers a hook on sp1-nova.ru (for Kommo - sp1-nova.com), and sp1 forwards the same POST to your address with the Authorization: Bearer header. If the address already exists, amo replaces its entire events. Deleting removes the address from all events. No more than 100 hooks per account.

Events: responsible_lead, responsible_contact, responsible_company, responsible_customer, responsible_task — change of responsible person; restore_lead, restore_contact, restore_company - restoration; add_lead, add_contact, add_company, add_customer, add_talk, add_task - adding; update_lead, update_contact, update_company, update_customer, update_talk, update_task - change; delete_lead, delete_contact, delete_company, delete_customer, delete_task - deletion; status_lead — change of lead stage; note_lead, note_contact, note_company, note_customer - note; add_message - incoming message, add_outgoing_message - outgoing message, add_chat_template_review - WhatsApp template for approval. For a list: add_catalog_{id}, update_catalog_{id}, delete_catalog_{id}.

FunctionWhat it does
webhooks_listAccount webhooks. destination keeps a single URL
webhooks_addSubscribe a URL to events. An existing URL is replaced entirely
webhooks_add_bearerWebhook via sp1-nova.ru that adds Authorization: Bearer on your URL
webhooks_deleteDelete a webhook by its exact URL. A proxied hook accepts the sp1 URL or your URL

Tasks and notes

FunctionWhat it does
tasks_listTask list
tasks_createCreate tasks
tasks_updateUpdate tasks
tasks_deleteDelete tasks by id
notes_listNotes on leads, contacts, companies or customers. With a card id, only that card
notes_createCreate notes
notes_updateUpdate notes. Each item needs the note id and the card entity_id
notes_deleteDelete notes by id

Pipelines, tags and custom fields

FunctionWhat it does
pipelines_listPipelines and stages
pipelines_getOne pipeline by id
pipelines_statusesStages of a pipeline
pipelines_createCreate pipelines. name, sort, is_main and is_unsorted_on are required. Stage color must be from the amo palette
tags_listTags of an entity, one page. page starts at 1, up to 250. Continue while _links.next is present
tags_deleteDelete tags by id
custom_fields_listCustom fields
custom_fields_createCreate custom fields
custom_fields_updateUpdate custom fields
custom_fields_deleteDelete custom fields by id

Directories and connections

links_link attaches another card to a lead, contact, company, or customer. The same call attaches a list item, including a product. For it, to_entity_type is catalog_elements, and to_entity_id is the element id from catalog_elements_list. The same list searches with query by name and filled fields. metadata needs catalog_id from catalogs_list and quantity, how many units to attach. price_id is optional. links_unlink removes this link: metadata still needs catalog_id.

FunctionWhat it does
catalogs_listCatalog list
catalog_elements_listCatalog elements, one page. query searches by name and filled fields. page starts at 1, up to 250. Continue while _links.next is present
catalog_elements_createCreate catalog elements
catalog_elements_updateUpdate catalog elements
catalog_elements_deleteDelete catalog elements
links_listLinks of a card, one page. page starts at 1, up to 250. Continue while _links.next is present
links_linkLink records to a card. List item and product: to_entity_type catalog_elements, metadata with catalog_id and quantity
links_unlinkUnlink records. List item and product: to_entity_type catalog_elements and metadata.catalog_id

Users

FunctionWhat it does
users_listAccount users
users_getOne user by id

Events

FunctionWhat it does
events_listEvent feed: calls, stage and owner changes. Can be filtered by date, author, and type. Up to 100 per page
events_getOne event by id

Mail

FunctionWhat it does
mail_mailboxesConnected mailboxes
mail_threadsMail threads. Folders: inbox, sent, drafts, spam, trash. Up to 50
mail_messagesMessages of one thread
mail_sendSend a message from an account mailbox, without attachments. If there are no mailboxes, connect one in amo mail

Messages in a lead

FunctionWhat it does
lead_messages_listClient chat messages in a lead. The reply includes channel, for example telegram. Several chats require chat_id
lead_messages_sendSend text to the client in the chat channel, for example telegram. This is not mail and not a note

Files, bot and notifications

FunctionWhat it does
files_listAccount files, one page. An empty drive is an empty list. page starts at 1, up to 250
files_uploadUpload a file, up to 100 MB. Can be linked to a lead, contact, company or customer
files_deleteDelete a file by uuid
bots_listBot list: id, name and type. Needed to run a bot
salesbot_runRun a bot. Take bot_id from the bot list
inbox_notifyNotification in the bell. Type: error or call

Wishlist

FunctionWhat it does
wishlist_listIdeas for the MCP connector. Search by text, filter by status
wishlist_addA new idea when the function does not exist. The text is moderated
wishlist_voteA vote for an existing idea. One account, one vote
bug_reportA widget bug or error: link, steps, expected and actual result

Chats

The MCP address is taken from the widget settings. Next, the client opens the OAuth login.

Claude

  1. Open claude.ai and go to Customize → Connectors.
  2. Click Add custom connector.
  3. Paste the MCP address from the widget settings.
  4. Confirm your login when the login window opens.
  5. On Free you can connect one connector. Claude Code with the same account will pick it up himself.

ChatGPT

  1. Open chatgpt.com/plugins.
  2. Click Add, then Create custom MCP server. On some accounts the button is also called Create MCP App.
  3. This is your connection. There is no need to publish the application to the market.
  4. Paste the MCP address from the widget settings.
  5. Confirm access to Kommo.
  6. Reading available on Plus, Pro, Business, Enterprise and Edu. Recording in Kommo - for Business, Enterprise and Edu.

Gemini

  1. Open gemini.google.com → Connected Apps → Custom apps.
  2. Add your server.
  3. Paste the MCP address from the widget settings.
  4. Confirm your entry.
  5. You need a personal Google account in the USA, over 18 years of age and an English interface.

Grok

  1. Open grok.com/connectors and select Custom.
  2. Paste the MCP address from the widget settings.
  3. Confirm your entry.
  4. Available on all plans. An administrator adds a connector to a team.

Perplexity

  1. Open Connectors → Custom connector and select Remote.
  2. Paste the MCP address from the widget settings.
  3. Confirm your entry.
  4. You need a Pro, Max or Enterprise plan.

Mistral

  1. In Mistral Work, open Connectors → Add Connector.
  2. Paste the MCP address from the widget settings.
  3. The server is added by the account administrator.
  4. Confirm your entry.

Editors

Same MCP address. OAuth login opens upon first connection.

Cursor

  1. Open Customize → MCPs or add the server to the mcp.json file.
  2. Specify the MCP address from the widget settings.
  3. When you connect for the first time, Cursor will open an input. Confirm it.

VS Code

  1. Run the MCP:Add Server command.
  2. Specify the remote server: MCP address from the widget settings.
  3. Login via OAuth takes place in Local harness.
  4. Tools appear in agent mode.

JetBrains

  1. Open Junie → Authorize or MCP Settings.
  2. Paste the MCP address from the widget settings.
  3. Confirm your entry.
  4. AI Assistant does not have OAuth login; it will not connect to this server.

Zed

  1. Open Settings → AI → MCP Servers and add Remote.
  2. Paste the MCP address from the widget settings.
  3. Click Authenticate and confirm your login.

Windsurf

  1. In Devin, add the server to mcp_config.json or with the devin mcp add command.
  2. Specify the MCP address from the widget settings.
  3. When you launch it for the first time, the login will open. Confirm it.

Cline

  1. Open MCP Servers → Remote Servers.
  2. Server type select streamableHttp.
  3. Paste the MCP address from the widget settings.
  4. Confirm your entry.

Agents and automation

MCP address from widget settings. Transport - Streamable HTTP.

Claude Code

  1. Run claude mcp add and specify the MCP address, or use the connector already added to claude.ai.
  2. Confirm your entry.
  3. The connector from the site is picked up if the login is not via an API key.

Codex

  1. Run codex mcp add.
  2. Specify the MCP address from the widget settings.
  3. Confirm your login upon first launch.
  4. One config works in the CLI, in the editor extension and in the ChatGPT application.

Gemini CLI

  1. Run gemini mcp add.
  2. Specify the MCP address from the widget settings.
  3. Confirm your entry.
  4. A regular Google account is not suitable: you need Code Assist or an API key.

Qwen Code

  1. Open settings.json.
  2. Write the MCP address into the httpUrl key. The url key means old SSE and will not work here.
  3. Confirm your entry.

OpenCode

  1. Open opencode.json.
  2. Add a server with a type field and a remote value. Without type, the server will not boot.
  3. Paste the MCP address from the widget settings.
  4. Confirm your entry.

Kiro

  1. Add the server to mcp.json: MCP address from widget settings.
  2. Confirm your entry.
  3. There is no MCP in the mobile application.

GitHub Copilot CLI

  1. In chat, run the /mcp add command.
  2. Specify the MCP address from the widget settings.
  3. This is a user config, not a repository file.
  4. Confirm your entry.

Warp

  1. Open Settings → Agents → MCP servers.
  2. Add server: MCP address from widget settings.
  3. Confirm your entry.
  4. The cloud agent does not pass this OAuth. Connect a local agent.

Goose

  1. Open Extensions → Add custom extension and select Remote.
  2. Specify the type streamable_http.
  3. Paste the MCP address from the widget settings.
  4. Confirm your entry.

LM Studio

  1. Open Program → mcp.json.
  2. Add remote server: MCP address from widget settings.
  3. Choose a model that can call tools.
  4. Confirm your login on the first call.

Raycast

  1. Run the Install MCP Server command.
  2. Paste the MCP address from the widget settings.
  3. Confirm your entry.
  4. You need a Pro, Pro+ or Max plan.

Copilot Studio

  1. In the agent, open Tools → Model Context Protocol.
  2. In the wizard, specify the MCP address.
  3. Author's license required. Confirm your entry.

n8n

  1. Add an MCP Client node to the AI agent.
  2. Transport select Streamable HTTP, authorization – OAuth2.
  3. Paste the MCP address from the widget settings.
  4. Pass OAuth2 login.

Open WebUI

  1. The administrator opens Admin → Integrations → External Tool Servers.
  2. Adds server: MCP address from widget settings.
  3. Login takes place separately for each user.