List notes

Lists the notes in a candidate's profile story.

MCP tool lever_read → list_notes

read

Returns the notes of all the candidate's opportunities, newest first, with the author, date and text. Secret notes appear only when your Lever role may see them. A next_cursor is returned while more notes remain.

Parameters

Parameters: list_notes
NameTypeDescription
opportunity_id string required string Opportunity ID from list_opportunities.
cursor string string Next page cursor from the previous call.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "lever_read",
    "arguments": {
      "operation": "list_notes",
      "arguments": {
        "opportunity_id": "opportunity_8c41d2"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "notes": [
      {
        "note_id": "a8f1d0c3-6e2b-4b79-8c15-0d9e3f7a2b46",
        "author": "Sam Okafor",
        "created_at": "2026-10-16T09:22:00Z",
        "secret": false,
        "text": "Portfolio is strong on mobile flows."
      }
    ],
    "next_cursor": null
  },
  "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.