notes

Search, browse, create, and delete Apple Notes. Use when user asks about notes, wants to find something in notes, create a new note, or delete notes.

SKILL.md

GitHub

Apple Notes Skill

Search, browse, create, and delete Apple Notes with fuzzy matching.

Prerequisites

Ensure the notes CLI is installed:

if ! command -v notes &> /dev/null; then
  pnpm add -g @cardmagic/notes
fi

Commands

Search notes

notes search "query" [-l limit] [-f folder] [-a after_date]

Recent notes

notes recent [-l limit]

Read a note by ID

notes read <id>

List folders

notes folders [-l limit]

Notes in folder

notes folder "folder_name" [-l limit]

Index statistics

notes stats

Rebuild index

notes index [-f|--force]

Create a note

notes create "Title" --body "Content" [--folder "Folder"]

Delete a note

notes delete "Title" [--folder "Folder"]

Examples

  • Search for "recipe": notes search "recipe"
  • Recent notes: notes recent
  • Notes in Taxes folder: notes folder Taxes
  • Read note ID 123: notes read 123
  • Create a note: notes create "Meeting Notes" --body "Agenda items..."
  • Delete a note: notes delete "Old Draft"