get_special_note

organizenote with action="clone"

Create a new attachment (image or file) for a note. Binary content as base64 or a data URL.

Create a note with title, content, type, and parent. Supports inline image/file embedding.

Create a revision snapshot of a note.

Delete an attachment.

Remove an attribute by ID.

organizenote with action="unlink"

Delete or restore a note via required action: "delete" or "undelete".

Skip the exact attempt and go straight to the ranked OR search.

Read an attachment (pass attachmentId) or list a note's attachments (pass noteId). With attachmentId, the body is returned by default — images come back as MCP image blocks. Pass includecontent=false when you only need metadata (e.g. checking size before pulling a large binary).

getattachment (default includecontent=true returns the body)

getattributes with attributeId

Get all attributes of a note (pass noteId) or a single attribute by ID (pass attributeId).

getspecialnote with kind="day"

getspecialnote with kind="inbox"

Read a note. Returns a metadata block (with a contentInfo size summary), the body, and embedded images by default; bodies over 50k chars are truncated with paging via contentstart/contentmaxchars. Pass includecontent=false for metadata-only reads (e.g. tree navigation).

getattachment with noteId (list form)

getnote (default includecontent=true returns the body)

Get recent changes (creations, modifications, deletions) across the tree, with optional subtree filtering.

getrevisions with noteId

Explore the hierarchy: children expanded depth levels (1-5) with titles, types, child counts, and branch IDs.

getrevisions with revisionId and includecontent=false

getrevisions with revisionId (default includecontent=true returns the HTML body)

Get note revisions. Pass noteId to list all revisions of a note; pass revisionId for a single revision with its HTML content (pass includecontent=false for metadata-only).

System ops via action: "backup" (create a DB backup by backupName), "export" (export a note subtree as ZIP, returned base64-encoded), "import" (import a base64 ZIP under a parent note), or "appinfo" (Trilium version/diagnostics).

organizenote with action="move"

Never retry. Strict Trilium semantics, byte-identical to the pre-fallback response.

Reorganize the note tree via action: "move" (new parent), "clone" (appear under multiple parents), "reorder" (change positions), "unlink" (remove a branch — cascades to note deletion if it's the last branch).

organizenote with action="reorder"

Full-text and attribute search with filters, subtree scoping (ancestorNoteId + ancestorDepth), ordering, limits, and query-parse diagnostics (debug). Plain-fulltext queries that return zero results are automatically retried as a relevance-ranked OR over the individual terms — see Graceful fuzzy fall

Upsert an attribute on a note (default), or mode="add" to always create — enabling multiple same-name labels.

deletenote with action="undelete"

writeattachment with mode="metadata"

writeattachment with mode="replace" or mode="edit"

writenote with mode="metadata"

writenote with mode="replace" (or mode="edit" for search/replace and diff)

Write to an attachment via mode: "metadata", "replace", or "edit".

Write to a note via mode: "metadata" (title/type/mime), "replace" (overwrite content), "append" (concatenate), "edit" (search/replace or unified diff). Supports inline image/file embedding in replace/append modes.