List leads
Leads from Pipelines → All leads, filtered by pipeline, stage, responsible user or overdue tasks.
MCP tool kommo_read → list_leads
read
Returns leads in the order Kommo shows them, with name, stage, sale amount, responsible user, tags and the due date of the closest task (null when the lead has no open task). Closed leads (Won and Lost) are not in the pipeline view, so they are not listed. Follow next_cursor until it is null.
Parameters
| Name | Type | Description |
|---|---|---|
| pipeline_id integer | integer | Pipeline ID from list_pipelines. |
| stage_id integer | integer | Stage ID from list_pipelines; needs pipeline_id. |
| responsible_user_id integer | integer | Only leads of this user. |
| overdue_tasks_only boolean | boolean | Only leads with an overdue task, the preset filter in the app. |
| query string | string | Search text for the lead name and contact. |
| 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_leads",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"leads": [
{
"lead_id": 24518301,
"name": "Yoga studio booking",
"pipeline_id": 8210123,
"stage": "Proposal",
"sale": 750,
"responsible": {
"user_id": 9102334,
"name": "Anna Berg"
},
"tags": [
"website"
],
"next_task_due": null,
"created_at": "2026-10-08T09:14:00+02:00"
},
{
"lead_id": 24518377,
"name": "Cafe loyalty app",
"pipeline_id": 8210123,
"stage": "Proposal",
"sale": 1900,
"responsible": {
"user_id": 9102334,
"name": "Anna Berg"
},
"tags": [],
"next_task_due": "2026-10-19T12:00:00+02:00",
"created_at": "2026-10-05T16:40:00+02:00"
}
],
"next_cursor": null
},
"isError": false
}