peerasak-u avatar

apple-notes

Reads, searches, lists, creates, and deletes notes in Apple Notes on macOS. Use when the user asks a

提供方 peerasak-u|开源

Apple Notes

Interacts with Apple Notes via the @peerasak-u/apple-notes CLI.

Quick Reference

Run commands

bunx @peerasak-u/apple-notes <command> [args]
CommandUsage
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)
move <title> <destination> [source]Move note to folder

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").