macos-notes_skill

Overview

This skill manages Apple Notes on macOS via an AppleScript-backed shell script. It creates, reads, lists, and searches notes, and targets specific accounts and folders when requested. Use it for quick jotting, meeting summaries, or retrieving existing notes on a macOS machine.

How this skill works

The skill calls a local script that accepts JSON on stdin and performs actions against the Notes app. It converts plain-text bodies into the HTML Notes store, returns plaintext when reading, and logs every action. Folder and account discovery is done by listing folders first; note operations validate inputs and skip password-protected notes.

When to use it

• Take a quick note or save an idea during a conversation
• Create meeting notes or a dated summary in a specific account/folder
• Search note titles or list recent notes
• Read a specific note by title
• Organize notes into specific account and folder locations

Best practices

• Always run list-folders first if account or folder isn’t specified to avoid ambiguity
• Specify both account and folder when you need a precise destination
• Pass data via JSON on stdin — never via CLI arguments to avoid leaks
• Provide plain-text bodies; use the html field only for rich formatting
• Remember password-protected notes are skipped and cannot be read or modified

Example use cases

• "Note this down: API key format..." — create-note with title and body
• "Show my recent notes" — list-notes with defaults to see recent entries
• "What did I write about passwords?" — search-notes with a query to find matching titles
• "Read my note about Hinge" — read-note by exact title (optionally scoped to folder/account)
• "Create a meeting summary in iCloud Notes" — list-folders to pick account/folder, then create-note with those fields