Add highlight
Highlight a passage of a transcript, or remove an existing highlight.
MCP tool otter_write → add_highlight
write
Finds the passage in the transcript and highlights it. If the text is not found or appears more than once, the call fails and lists the matches, so nothing is highlighted by guess. Set remove to true to remove the highlight again. People the conversation is shared with, and anyone with a public link, can see highlights, so keep notes for yourself out of them. add_highlight runs without asking first: it sends nothing to anyone and is undone with one call.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id string required | string | Conversation ID from list_conversations or search_transcripts. |
| text string required | string | The passage exactly as it appears in the transcript. |
| remove boolean | boolean | true removes the highlight. Default: false. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "otter_write",
"arguments": {
"operation": "add_highlight",
"arguments": {
"conversation_id": "cv_7f3a91",
"text": "We decided to go with the flat-rate option for the pilot."
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversation_id": "cv_7f3a91",
"highlight_id": "hl_31",
"timestamp": "12:41",
"text": "We decided to go with the flat-rate option for the pilot.",
"removed": false
},
"isError": false
}