Count the notes currently in the local index.

Index all Apple Notes for semantic search. Tell the user this can take from a few seconds to a few minutes depending on how many notes they have.

Get a note's full content and details by exact title. Optional folder scopes the title lookup to that folder — pass it whenever you know which folder the target note lives in to avoid shadowing by homonyms in other folders/accounts.

Search notes by meaning and by text (hybrid vector + full-text search).

Create a new Apple Note. Content must be HTML without newlines.

Replace the body of an existing Apple Note matched by exact title. Content must be HTML without newlines. The current body is snapshotted to disk before being overwritten. Fails (and leaves the note untouched) if zero or multiple notes share the title within the resolved scope (the whole Notes app if folder is omitted, otherwise just that folder). Pass folder whenever you know which folder the target note lives in — it eliminates spurious 'multiple notes share that title' errors caused by homonyms in other accounts/folders.

Append HTML to the body of an existing Apple Note matched by exact title. Content must be HTML without newlines. The current body is snapshotted to disk before being modified. Fails (and leaves the note untouched) if zero or multiple notes share the title within the resolved scope (the whole Notes app if folder is omitted, otherwise just that folder). Pass folder whenever you know which folder the target note lives in.

Snapshot the current HTML body of a note (matched by exact title) to disk and return the file path. Useful before risky multi-step edits. Fails if zero or multiple notes share the title within the resolved scope. Pass folder to scope the lookup to a single folder.

Return the names of all Apple Notes folders.

List the titles of all notes inside a named Apple Notes folder.

Create a new Apple Note inside a specific folder. Content must be HTML without newlines. Fails if the folder does not exist — use list-folders to check first.

Move an existing Apple Note (matched by exact title) into the named destination folder. Optional source_folder scopes the title lookup to that folder, so a homonym in another folder doesn't trigger ambiguity. Fails if the note is missing, ambiguous within the resolved scope, or the destination folder does not exist.