List every Apple Notes folder, with its full path and how many notes it holds.

This is where folder_ids come from. Folders nest, and two can share a name, so path ("Work/Clients") is what tells them apart for a human while folder_id is what the other tools take.

Returns everything rather than a page: the whole point is to see the shape of the archive, and a folder list is small.

List notes as summaries, pinned first, without fetching their bodies.

Each entry carries the note_id that get_note and the write tools need, plus the folder it lives in and when it changed. Use get_note to read one.

Read one note in full, with its body as Markdown.

Checklists come back as "- [x]" / "- [ ]" with their real ticked state, and attachments as "[attachment: type]" placeholders -- the files themselves are not read, so this says an image is there, not what is in it.

Search note titles and full note bodies, case-insensitively.

The entire archive is searched, not a recent window, so a total of 0 means the text is genuinely not in any note. Body matches come back with an excerpt around the hit; each result says whether it matched on title or body.

Create a note. The first line of body becomes its title.

body is Markdown. Bullets, numbered lists, bold, italic, strikethrough, links and code blocks all render. Two things do not, because Notes does not expose them to scripts: "# Heading" becomes bold text, and "- [ ]" becomes a plain bullet rather than a checkbox.

Replace a note's entire body. The first line of body becomes its title.

This is a whole-note replacement, not an edit -- Apple's scripting interface offers no way to change part of a note. Anything not in body is gone. Read the note with get_note first unless you are deliberately starting over.

Refuses when the note holds attachments or checklists, because neither can be rebuilt from Markdown.

Add text to the end of a note, keeping what is already there.

The existing note is read from the database and re-sent with the new text on the end, because Notes has no append operation -- so this is a whole-note rewrite underneath, and it refuses on attachments and checklists for the same reason update_note does.

Move a note to a different folder.

Move a note to Recently Deleted.

Not a purge. Notes keeps it for 30 days and the operator can restore it from the app, which is the only way back -- this server cannot undo it.

Create a folder, optionally nested inside another.

Move a folder, and every note in it, to Recently Deleted.

Refuses a folder that still has notes unless delete_notes_inside is set, because the notes go with it and nothing in the call site says how many there are.