| name | apple-notes |
| description | Manage Apple Notes via memo CLI: create, search, edit. |
| license | MIT |
| compatibility | macOS only. Requires the `memo` CLI and Automation access to Notes.app. |
| metadata | {"gini":{"version":"1.0.0","author":"Gini","platforms":["macos"],"prerequisites":{"commands":["memo"]}}} |
Apple Notes
Use memo to manage Apple Notes directly from the terminal. Notes sync across all Apple devices via iCloud.
Prerequisites
- macOS with Notes.app
- Install:
brew tap antoniorodr/memo && brew install antoniorodr/memo/memo
- Grant Automation access to Notes.app when prompted (System Settings → Privacy → Automation)
When to Use
- User asks to create, view, or search Apple Notes
- Saving information to Notes.app for cross-device access
- Organizing notes into folders
- Exporting notes to Markdown/HTML
When NOT to Use
- Obsidian vault management → use the
obsidian skill
- Bear Notes → separate app (not supported here)
- Quick agent-only notes → use the
memory tool instead
Quick Reference
View Notes
memo notes
memo notes -f "Folder Name"
memo notes -s "query"
Create Notes
memo notes -a
memo notes -a "Note Title" is not supported by current memo versions. For a non-interactive quick note, use AppleScript instead:
osascript -e 'tell application "Notes"' \
-e 'make new note with properties {name:"Test note", body:"Test note<br><br>Created by Gini as a test."}' \
-e 'end tell'
Edit Notes
memo notes -e
Delete Notes
memo notes -d
Move Notes
memo notes -m
Export Notes
memo notes -ex
Limitations
- Cannot edit notes containing images or attachments
- Interactive prompts require terminal access (use pty=true if needed)
- macOS only — requires Apple Notes.app
Rules
- Prefer Apple Notes when user wants cross-device sync (iPhone/iPad/Mac)
- Use the
memory tool for agent-internal notes that don't need to sync
- Use the
obsidian skill for Markdown-native knowledge management