Apple Notes

1---
2name: apple-notes
3description: Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks to add a note, list notes, search notes, or manage note folders.
4emoji: "📝"
5requires: { "bins": ["memo"], "os": ["darwin"] }
6install: ["brew tap antoniorodr/memo && brew install antoniorodr/memo/memo"]
7---
8 
9# Apple Notes CLI
10 
11Use `memo notes` to manage Apple Notes directly from the terminal. Create, view, edit, delete, search, move notes between folders, and export to HTML/Markdown.
12 
13Setup
14 
15- Install (Homebrew): `brew tap antoniorodr/memo && brew install antoniorodr/memo/memo`
16- Manual (pip): `pip install .` (after cloning the repo)
17- macOS-only; if prompted, grant Automation access to Notes.app.
18 
19View Notes
20 
21- List all notes: `memo notes`
22- Filter by folder: `memo notes -f "Folder Name"`
23- Search notes (fuzzy): `memo notes -s "query"`
24 
25Create Notes
26 
27- Add a new note: `memo notes -a`
28  - Opens an interactive editor to compose the note.
29- Quick add with title: `memo notes -a "Note Title"`
30 
31Edit Notes
32 
33- Edit existing note: `memo notes -e`
34  - Interactive selection of note to edit.
35 
36Delete Notes
37 
38- Delete a note: `memo notes -d`
39  - Interactive selection of note to delete.
40 
41Move Notes
42 
43- Move note to folder: `memo notes -m`
44  - Interactive selection of note and destination folder.
45 
46Export Notes
47 
48- Export to HTML/Markdown: `memo notes -ex`
49  - Exports selected note; uses Mistune for markdown processing.
50 
51Limitations
52 
53- Cannot edit notes containing images or attachments.
54- Interactive prompts may require terminal access.
55 
56Notes
57 
58- macOS-only.
59- Requires Apple Notes.app to be accessible.
60- For automation, grant permissions in System Settings > Privacy & Security > Automation.
61