| name | description | homepage | metadata | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
apple-notes |
Manage Apple Notes via the `memo notes api` CLI on macOS (create, view, edit, delete, search, move, and export notes). Non-interactive, machine-friendly API for scripts and AI agents. |
|
Use memo notes api to manage Apple Notes from the terminal. Non-interactive, machine-friendly commands for scripts and AI agents. Output is plain text, well-parsable (TSV, lines, JSON).
- Install (Homebrew):
brew tap forever-young/tap && brew install forever-young/tap/memo - Manual (pip):
pip install .(after cloning the repo) - macOS-only; if prompted, grant Automation access to Notes.app.
- List all notes:
memo notes api list - Filter by folder:
memo notes api list -f "Folder Name" - Output formats:
--format tsv(default),lines,json
- Add note from stdin:
echo "# Title\nBody" | memo notes api add -f "Folder Name"
- Show note body as Markdown:
memo notes api show <note-id>
- Replace note body from stdin:
memo notes api edit <note-id>(pipe or redirect)
- Delete a note:
memo notes api delete <note-id>
- Move note to folder:
memo notes api move <note-id> <target-folder>
- Search by title:
memo notes api search "query" - Search in body too:
memo notes api search "query" --body - Filter by folder:
memo notes api search "query" -f "Folder"
- List folders:
memo notes api folders - Delete folder:
memo notes api remove <folder-path> --force
- Export all notes:
memo notes api export --path /path/to/dir - With Markdown conversion:
memo notes api export --path /path/to/dir --markdown
- macOS-only. Requires Apple Notes.app.
- For automation, grant permissions in System Settings > Privacy & Security > Automation.