Add note

Add an internal note to a conversation.

MCP tool help_scout_write → add_note

write

Adds a note as the Note editor does. A note is never sent to the customer and any Help Scout user can add one to any conversation. Mention teammates with @name to bring them in. Help Scout offers no draft for a note, so it is saved at once. It reaches no customer, so it does not ask for your OK.

Parameters

Parameters: add_note
NameTypeDescription
conversation_id integer required integer Conversation number from search_conversations.
text string required string Note body. Use @name to mention a teammate.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "help_scout_write",
    "arguments": {
      "operation": "add_note",
      "arguments": {
        "conversation_id": 1,
        "text": "text"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversation_id": 48244,
    "thread_id": 903340,
    "type": "note",
    "mentions": [
      "Maria Silva"
    ]
  },
  "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.