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
| Name | Type | Description |
|---|---|---|
| conversation_id integer required | integer | Conversation number from search_conversations. |
| text string required | string | Note body. Use @name to mention a teammate. |
tools/call
{
"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
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversation_id": 48244,
"thread_id": 903340,
"type": "note",
"mentions": [
"Maria Silva"
]
},
"isError": false
}