apple-notes

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                        # List all notes
memo notes -f "Folder Name"       # Filter by folder
memo notes -s "query"             # Search notes (fuzzy)

Create Notes

memo notes -a                     # Interactive editor (optionally with -f "Folder Name")

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                     # Interactive selection to edit

Delete Notes

memo notes -d                     # Interactive selection to delete

Move Notes

memo notes -m                     # Move note to folder (interactive)

Export Notes

memo notes -ex                    # Export to HTML/Markdown

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

1. Prefer Apple Notes when user wants cross-device sync (iPhone/iPad/Mac)
2. Use the memory tool for agent-internal notes that don't need to sync
3. Use the obsidian skill for Markdown-native knowledge management