apple-notes

Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks HanzoBot to add a note, list notes, search notes, or manage note folders.

Apple Notes CLI

Use memo notes to manage Apple Notes directly from the terminal. Create, view, edit, delete, search, move notes between folders, and export to HTML/Markdown.

Setup

• Install (Homebrew): brew tap antoniorodr/memo && brew install antoniorodr/memo/memo
• Manual (pip): pip install . (after cloning the repo)
• macOS-only; if prompted, grant Automation access to Notes.app.

View Notes

• List all notes: memo notes
• Filter by folder: memo notes -f "Folder Name"
• Search notes (fuzzy): memo notes -s "query"

Create Notes

• Add a new note: memo notes -a
• Opens an interactive editor to compose the note.
• Quick add with title: memo notes -a "Note Title"

Edit Notes

• Edit existing note: memo notes -e
• Interactive selection of note to edit.

Delete Notes

• Delete a note: memo notes -d
• Interactive selection of note to delete.

Move Notes

• Move note to folder: memo notes -m
• Interactive selection of note and destination folder.

Export Notes

• Export to HTML/Markdown: memo notes -ex
• Exports selected note; uses Mistune for markdown processing.

Limitations

• Cannot edit notes containing images or attachments.
• Interactive prompts may require terminal access.

Notes

• macOS-only.
• Requires Apple Notes.app to be accessible.
• For automation, grant permissions in System Settings > Privacy & Security > Automation.