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

Parameters: get_lead
NameTypeDescription
lead_id integer required integer Lead ID from list_leads or get_lead.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "kommo_read",
    "arguments": {
      "operation": "get_lead",
      "arguments": {
        "lead_id": 1
      }
    }
  }
}

Example response

JSON

{
  "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
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.