List every Apple Notes folder with its path and note count.

List notes, newest first. Optionally scoped to one folder. Trash is excluded.

Search notes by title, or by title and body with search_body=true (slower, capped scope). total is how many matched, notes the first limit of them, whichever mode.

Read one note by id (preferred) or by title. The body comes back as Markdown and never repeats the title, which is already the note's name. The default reads the note's own store, so checked boxes, block quotes, link targets and highlights come back intact; rich:false means the store was out of reach and the body degraded to the exported HTML, which carries none of those. format=html returns the raw HTML. Attachments appear as placeholder marks, never bytes: to copy a note to disk or a vault, use export_note, which writes the images as files too.

What a note carries besides text: images, scans, drawings, files. One entry per mark in the note's Markdown, in the same order, so mark n and attachment n are the same thing. A table is not listed: its mark became the pipe rows in the body. Use get_attachment to look at one.

Fetch one attachment of a note by its index in list_attachments. Bytes as Notes holds them, under their own name and type. A drawing has no original, so it comes back as the picture Notes renders of it, which is the only form it exists in.

Create a new note. Title becomes the first line. The body is Markdown: inline styles, links, lists, tables, code fences, quotes, ==highlights==, and '- [ ]' checklists are converted.

Append to the end of an existing note. The text is Markdown, like create_note's body. The rest of the note is untouched: the fragment is pasted at the caret, so the note's own styles and attachments stay as they are.

Replace a note's body. Destructive for that note: the old body is overwritten. Title is kept unless a new one is given. The body is Markdown, like create_note.

One pass over a folder of .md files, one direction per file. A file opts in with frontmatter apple-note-sync: push sends the file into the note, pull brings the note into the file, off pauses. The file's own name says which note, and it must match exactly one: a name matching none or several is reported and neither side is touched. Rename the note in Notes and the pair is lost until the file is renamed to match. Pass folder to mirror a whole Notes folder: notes there with no file yet are created as pull files, attachments written beside them, so one call covers everything. Deletions never propagate.

Dry-run of sync_now: reports what would be pushed, pulled or created, without writing anything.

Write an existing note to a new Markdown file, with its images, scans and drawings written beside it and linked. The one way attachment bytes reach disk. Rewrites a file it wrote before, refuses any other existing file rather than overwriting it. The file is stamped for pull, so later passes keep it up to date.

Create a new note from a Markdown file. Its image links become real attachments. Creates only: a name that already exists in Notes is refused, so nothing is overwritten.