List chat conversations
Conversations from Communication → Chat inbox, with the last message and whether it is unanswered.
MCP tool kommo_read → list_conversations
read
Returns conversations newest first, with the channel, the contact, the linked lead_id (null if the chat is not a lead yet) and the last message with who wrote it: client, user or bot. A chat a Salesbot answered can still count as unanswered when the bot is set to leave messages unanswered. Follow next_cursor until it is null.
Parameters
| Name | Type | Description |
|---|---|---|
| unanswered_only boolean | boolean | Only chats where the client wrote last and nobody answered. |
| responsible_user_id integer | integer | Only chats of leads owned by this user. |
| query string | string | Search text, the same as the Chat inbox search field. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kommo_read",
"arguments": {
"operation": "list_conversations",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversations": [
{
"chat_id": "c4b19e07",
"channel": "WhatsApp",
"contact_name": "Ana Lopez",
"lead_id": 24518301,
"unanswered": true,
"last_message": {
"from": "client",
"text": "What does the yoga studio package cost per month?",
"at": "2026-10-19T18:03:00+02:00"
}
}
],
"next_cursor": null
},
"isError": false
}