Mac Notes Agent

Overview

This skill lets the agent talk to Apple Notes on macOS using AppleScript
(via osascript). It is implemented as a small Node.js CLI:

CODEBLOCK0

Requires macOS with the built-in Notes app and osascript available.

All operations target the default Notes account. Optionally you can specify
which folder to use.

Commands

1) Add a new note

CODEBLOCK1

• - --title (required): Note title
• INLINECODE3 (required): Note body text. Use \n for line breaks.
• INLINECODE5 (optional): Folder name. If omitted, uses system default folder. If folder doesn't exist, it will be created.

Line breaks (\n) are converted to <br> tags internally for proper rendering in Notes.

Result (JSON):

CODEBLOCK2

2) List notes

CODEBLOCK3

• - Lists notes in the given folder (or all folders if omitted).
• Output is JSON array with title, folder, creationDate, and synthetic id.

3) Read a note (get)

CODEBLOCK4

4) Update a note (replace body)

CODEBLOCK5

• - Replaces the entire body of the matching note.
• Can also use --id for identification.

5) Append to a note

CODEBLOCK6

• - Appends new content to the end of the existing note.

6) Delete a note

CODEBLOCK7

7) Search notes

CODEBLOCK8

• - Searches note titles and bodies for the keyword.

Identification Model

Apple Notes doesn't expose stable IDs. This CLI uses:

• - Primary key: INLINECODE13
• Synthetic ID: INLINECODE14

When multiple notes share the same title, the CLI operates on the most recently created one.

Environment

• - macOS only: Uses AppleScript via INLINECODE15
• No npm dependencies: Uses only Node.js built-ins (child_process)