Reads, searches, lists, creates, and deletes notes in Apple Notes on macOS. Use when the user asks about their notes, wants to save information to Notes, or needs to find something they wrote in Apple Notes.
View on GitHubpeerasak-u/apple-notes-skill
apple-notes
skills/apple-notes/SKILL.md
January 20, 2026
Select agents to install to:
npx add-skill https://github.com/peerasak-u/apple-notes-skill/blob/main/skills/apple-notes/SKILL.md -a claude-code --skill apple-notesInstallation paths:
.claude/skills/apple-notes/# Apple Notes Interacts with Apple Notes via the `@peerasak-u/apple-notes` CLI. ## Quick Reference ### Run commands ```bash bunx @peerasak-u/apple-notes <command> [args] ``` | Command | Usage | |---------|-------| | `search <query>` | Search notes by body content | | `list <query>` | List notes by title (returns indexes) | | `read <title> [folder]` | Read note content | | `read-index <query> <index>` | Read by index from list result | | `recent [count] [folder]` | Get recent notes (default: 5) | | `create <title> <body> [folder]` | Create note from Markdown | | `delete <title> [folder]` | Delete note (exact match) | **Full command details**: See [references/COMMANDS.md](references/COMMANDS.md) ## Common Workflows ### Find and read a note ```bash bunx @peerasak-u/apple-notes list "budget" bunx @peerasak-u/apple-notes read-index "budget" 2 ``` ### Create a note ```bash bunx @peerasak-u/apple-notes create "Meeting Notes" "# Agenda\n- Item 1\n- Item 2" "Work" ``` ### Check recent activity ```bash bunx @peerasak-u/apple-notes recent 10 ``` ## Output Format - Note content returns as Markdown - If HTML conversion fails, output starts with `[RAW_HTML]` - Errors return strings starting with `Error:` ## Folder Paths Specify folders as simple names (`"Work"`) or nested paths (`"Work/Projects/2024"`).