Add a note to a candidate
Add an internal note to a candidate profile.
MCP tool homerun_write → add_candidate_note
write
Adds a note that the hiring team sees on the profile and the candidate never sees. It reaches nobody unless it mentions a colleague, which the agent avoids, so it does not wait for your OK. Returns the note with its time.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id string required | string | Job ID from list_jobs. |
| candidate_id string required | string | Candidate ID from list_candidates. |
| text string required | string | The note text. Leave out @mentions: they notify colleagues. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "homerun_write",
"arguments": {
"operation": "add_candidate_note",
"arguments": {
"job_id": "job_8c41d2",
"candidate_id": "candidate_8c41d2",
"text": "text"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"candidate_id": "ap_K2mP7rS1uW5yA9bC3dE6",
"status": "added",
"text": "First reply sent 22 Oct. Promised an answer on interviews by Friday.",
"created_at": "2026-10-22T09:14:00Z"
},
"isError": false
}