Add candidate note

Add a text note to a candidate record.

MCP tool jobadder_write → add_candidate_note

write Confirm

Adds a note to the candidate and returns its note_id and creation time. The note is plain text, visible to your team in JobAdder, and Cotlet has no tool to delete it. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: add_candidate_note
NameTypeDescription
candidate_id string required string Candidate id from search_candidates.
text string required string Note text.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "jobadder_write",
    "arguments": {
      "operation": "add_candidate_note",
      "arguments": {
        "candidate_id": "cand_20931",
        "text": "Screening call 21 Oct. Available from 1 December, wants hybrid, salary expectation 85k."
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "note_id": "note_77412",
    "candidate_id": "cand_20931",
    "created_at": "2026-10-22T17:05:00+11: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.