Get a lead
The lead card: fields, linked contact and company, tasks and notes.
MCP tool kommo_read → get_lead
read
Returns what the lead card shows: stage, sale amount, responsible user, tags, the linked contact and company, open tasks and the latest notes, newest first. Use it before writing to a lead so the write fits what is already there. A lead you have no right to see returns APP_PERMISSION_DENIED.
Parameters
| Name | Type | Description |
|---|---|---|
| lead_id integer required | integer | Lead ID from list_leads or get_lead. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kommo_read",
"arguments": {
"operation": "get_lead",
"arguments": {
"lead_id": 1
}
}
}
} Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"lead_id": 24518301,
"name": "Yoga studio booking",
"stage": "Proposal",
"sale": 750,
"responsible": {
"user_id": 9102334,
"name": "Anna Berg"
},
"tags": [
"website"
],
"contact": {
"contact_id": 1180442,
"name": "Ana Lopez"
},
"company": {
"company_id": 660201,
"name": "Lotus Yoga"
},
"tasks": [],
"notes": [
{
"text": "Sent proposal for 4 sessions a month.",
"created_at": "2026-10-12T11:02:00+02:00"
}
]
},
"isError": false
}