Search notes by text in the title/body, optionally scoped to a notebook or tag.

Returns brief records (id, title, snippet, notebooks, flags, timestamps), most-recently-updated first. Omit query to list recent notes.

Get a single note's full content and metadata in the requested format.

List all notebooks as a parent/child tree, with per-notebook note counts.

List notes by a filter: recent, notebook (needs notebook_id), tag (needs tag_id), bookmarked, pinned, trashed, or templates.

List all tags with their note counts.

List the attachments/files referenced by a note, with on-disk paths.

Read an attachment by file id. Small files are returned inline as base64; large files return their on-disk path instead.

Return library statistics (counts of notes, notebooks, tags, files) and the DB path.

Create a new note.

By default this uses the upnote:// URL scheme (app-native and safe while UpNote is running); the app generates the note, so no id is returned. Set the UPNOTE_WRITE_MODE=sqlite environment variable to create via direct SQLite instead (requires the app to be quit; returns the new note id). For 'notebook', pass a notebook title (URL mode) or notebook id (sqlite mode).

Create a new notebook via the upnote:// URL scheme.

Edit a note's title/content/flags via direct SQLite write.

Requires the UpNote app to be quit (override with UPNOTE_ALLOW_WHILE_RUNNING=1). A database backup is taken automatically. Use dry_run=true to preview.

Move a note into the given notebook (direct SQLite write; app must be quit).

Append content to the end of a note, preserving its existing body verbatim.

Unlike update_note (which replaces content), this concatenates the new content after the current html, optionally under an '## heading' divider. Safe for rich/image-heavy notes. Direct SQLite write; the app must be quit.

Fold one note into another: append the source's body under an '## ' divider, migrate its images so nothing is orphaned, then trash the source.

Ideal for triaging an inbox/whiteboard note into an existing canonical note. Direct SQLite write; the app must be quit. Use dry_run=true to preview.

Delete a note: move to trash (default) or hard-delete with hard=true. Direct SQLite write; the app must be quit. Use dry_run=true to preview.

Restore a trashed/deleted note (direct SQLite write; app must be quit).

Add a tag (by title or id) to a note, creating the tag if needed. Direct SQLite write; the app must be quit.

Remove a tag (by title or id) from a note (direct SQLite write; app must be quit).

Open a note in UpNote (by note_id) or run a search in the app (by query) using the upnote:// URL scheme.