List candidate notes
Notes on a candidate's Notes tab with Note Action, author and date, newest first.
MCP tool bullhorn_read → list_candidate_notes
read
Reads the Notes tab of one candidate, newest first. Each note has its Note Action, the Comments text, who added it and when, and the records it references. Use it before add_note to avoid doubling a note.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id integer required | integer | Candidate ID from search_candidates or find_matching_candidates. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bullhorn_read",
"arguments": {
"operation": "list_candidate_notes",
"arguments": {
"candidate_id": 1
}
}
}
} Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"notes": [
{
"note_id": 6120044,
"note_action": "Phone Call",
"comments": "Open to contract. Free from 3 Nov.",
"added_by": "Dana Whitfield",
"added_at": "2026-10-22T15:40:00Z",
"references": [
{
"type": "job",
"id": 77314
}
]
}
],
"next_cursor": null
},
"isError": false
}