Notes

List notes (paginated). Returns up to `limit` rows per call (max 200). If `has_more` is true, call again with `offset=offset+limit` to fetch the next page.

Get full content of a note by ID.

Create a new note with title, content, tags, and optional folder.

Update note fields (title, tags, pin) or REPLACE its content. WARNING: content_text OVERWRITES the entire body — to ADD text to an existing note use append_to_note instead.

Append text to the END of an existing note's body WITHOUT overwriting it. The text is added server-side in one atomic operation, so appending to a long note stays cheap and two appends can never overwrite each other. Use this for any 'add to note / append / допиши / добавь в заметку' request — never use update_note to add content, because update_note REPLACES the whole body.

Move note to a folder, or root with empty folder_id.

Delete a note (moves to trash).

Permanently delete a note. Cannot be undone.

Delete ALL notes in a folder (bulk). By default moves them to trash; pass permanent=true to permanently delete instead. folder_id accepts a folder UUID OR a folder name — auto-resolved either way.

Delete MULTIPLE notes at once. Pass note_ids (list of IDs) OR note_titles (list of names, auto-resolved). Moves them to trash by default; pass permanent=true to delete permanently. Use when the user wants to delete 2+ notes.

Archive MULTIPLE notes at once. Pass note_ids (list) OR note_titles (list of names).

Remove MULTIPLE notes from the archive (unarchive). Pass note_ids OR note_titles.

Restore MULTIPLE notes from trash. Pass note_ids OR note_titles.

Full-text search across all notes (paginated). Returns up to `limit` results per call (max 50). If `has_more` is true, call again with `offset=offset+limit` to fetch the next page. Do NOT claim to have searched all notes until `has_more` is false.

Move MULTIPLE notes into the same folder at once. Pass note_ids (list of IDs) OR note_titles (list of names, auto-resolved), plus folder_id (a folder UUID or name — empty moves them to root). Use when the user wants to move 2+ notes.

List all note folders.

Resolve a notes folder by name (case-insensitive). Returns the folder_id plus match_quality ('exact' | 'prefix' | 'contains' | 'none'). Use this INSTEAD of list_folders+manual-match when you only need one folder — it's a single call and gives a stable ID across chain steps.

Create a new notes folder.

Rename an existing notes folder.

Delete a folder (notes move to root).

Delete a folder AND all notes inside it. folder_id accepts a folder UUID OR a folder name — auto-resolved either way. By default moves notes to trash then deletes the folder; pass permanent=true to permanently delete notes instead.

Delete MULTIPLE folders at once. Pass folder_ids (list) OR folder_names (list of names). By default notes inside are just detached (moved to root); pass with_contents=true to trash (or permanent=true to permanently delete) the notes inside each folder too. Use for bulk/multi-select folder cleanup.

List all notes in trash.

Restore a note from trash.

Permanently delete all trashed notes.

Silently save the note body from the editor as the user types (debounced autosave). Does not refresh any panel and does not emit an update event, so typing is never interrupted. For explicit saves use note_save.

Save a note field from the editor panel (title, content, tags, folder, pin, archive).

Upload a file attachment to a note.

Delete a file attachment from a note.

Delete SEVERAL file attachments at once. Pass att_ids (list of attachment UUIDs). Use when the user wants to remove 2+ attachments in one request.

Duplicate a note — copies title, content, folder, and tags into a new note.

Export a note as Markdown. Returns the converted content with a download button.