API Key

🗒️ Apple Notes

Read, search and write Apple Notes on your Mac from anywhere.

What you can do

Run apple-notes-api on the Mac that has Notes, then:

agentio notes profile add --url https://mac-mini.example.ts.net

agentio asks for the API key the server printed when it was installed.

Note ids look like x-coredata://…. Quote them in the shell.
update --body replaces the whole body. Read the note first if you want to keep any of it. A new body turns checklists into plain lists, losing which items are ticked; moving a note with --folder alone leaves its body untouched.
delete moves the note to Recently Deleted, where Notes keeps it for 30 days.
A folder is found by its name, so two accounts with a folder of the same name are ambiguous.
Locked notes cannot be read or changed.
get shows which checklist items are ticked (- [x]) when the server has Full Disk Access on the Mac. Ticking items is not possible.

agentio notes folders

List folders, with the account each belongs to

--profile <name> --json
agentio notes list

List notes (title, folder, dates), without their bodies

--profile <name> --json --folder <name> --limit <n>
agentio notes search <query>

Find notes whose title or text contains a phrase (case does not matter)

--profile <name> --json --folder <name> --limit <n>
agentio notes get <id>

Read a note

--profile <name> --json --format <format>
agentio notes create

Create a note

--profile <name> --json --title <title> --body <text> --file <path> --format <format> --folder <name>
agentio notes update <id>

Change a note's title, replace its body, or move it to another folder

--profile <name> --json --title <title> --body <text> --file <path> --format <format> --folder <name>
agentio notes delete <id>

Move a note to Recently Deleted

--profile <name> --json