Agent skill
apple-notes
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/apple-notes
SKILL.md
Apple Notes
Interacts with Apple Notes via the @peerasak-u/apple-notes CLI.
Quick Reference
Run commands
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
Common Workflows
Find and read a note
bunx @peerasak-u/apple-notes list "budget"
bunx @peerasak-u/apple-notes read-index "budget" 2
Create a note
bunx @peerasak-u/apple-notes create "Meeting Notes" "# Agenda\n- Item 1\n- Item 2" "Work"
Check recent activity
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").
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?