Skip to main content

​
Discontinued

The four tools this page used to cover — update_note, update_folder, move_folder, and reorder_folders — were removed from the MCP server on 2026-07-20 (OpenAI app review, #46) and no longer exist. Tiro MCP in production is currently entirely read-only (every tool has readOnlyHint: true). If you need to change note titles or folder structure:
  • Edit directly in the Tiro app, or
  • Use the REST API (the regular API-key-authenticated path, not MCP).

​
Content editing and reset in dev

Content editing and reset tools are being tested in dev and are not available in production. Paragraph tools require note:write, summary tools require note_summary:write, and document section tools require note_document:write. Each write scope includes read for the same resource. The user must also have permission to edit the note. Pass the etag from a read response to recovery tools. restore_note_summary_content accepts exactly one of the existing expectedRevision or the new etag. On a conflict, read the content again and choose recovery again; do not automatically retry with a new etag. Document reset applies to the entire document; section reset is not available. reset_paragraph keeps its existing behavior: it resets one paragraph’s transcript, translation, speaker-attributed text, and speaker assignments, while preserving its summary. Successful commands return updated recovery state, so read the content again. undo_paragraph_content accepts field values transcript, translated, diarized-transcript, and summary. It reverses one saved change in one paragraph and field. Summary Undo supports only new saves with recoverable history. reset_paragraph_contents takes noteGuid, kind, and etag, without paragraphUuid. kind is original, translated, or summary. It resets that kind across all paragraphs atomically. original resets plain and speaker-attributed transcripts, including speaker assignments. Translations and paragraph summaries remain unchanged. translated resets only translations, and summary resets only paragraph summaries. The reset content’s earlier Undo history ends; other content and its Undo history remain available. Original reset also prevents Undo of affected earlier speaker changes. Any validation failure leaves all paragraphs unchanged. The response contains a new etag, undoAvailable: false, and canReset: false for this reset; read the content and availability again. Read get_note_transcript first. Each paragraph’s editState.canResetByKind reports reset availability across all paragraphs for the three kinds.