openclaw/skills/apple-notes/SKILL.md

name	description	homepage	metadata
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 OpenClaw to add a note, list notes, search notes, or manage note folders.	https://github.com/jacob-bayer/memo	openclaw emoji os requires install 📝 darwin bins memo id kind tap formula bins label brew brew jacob-bayer/tap memo memo Install memo via Homebrew id kind package bins label pipx pipx git+https://github.com/jacob-bayer/memo memo Install memo via pipx

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 jacob-bayer/tap && brew install jacob-bayer/tap/memo
• Install (pipx): pipx install git+https://github.com/jacob-bayer/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.

Non-Interactive API (for agents and scripts)

Use memo notes api <subcommand> for scripting and agent workflows. All commands are non-interactive and machine-readable.

• List notes: memo notes api list [--folder FOLDER] [--format tsv|json|lines]
• Show note body (Markdown): memo notes api show <note-id>
• Edit note from stdin: echo "# Updated content" | memo notes api edit <note-id>
• Add note from stdin: echo "# New note" | memo notes api add --folder "Folder Name"
• Delete note: memo notes api delete <note-id>
• Move note: memo notes api move <note-id> <target-folder>
• List folders: memo notes api folders [--format tsv|json]
• Search notes: memo notes api search <query> [--folder FOLDER] [--format tsv|json] [--body]
• Remove folder: memo notes api remove <folder-name> --force
• Export notes: memo notes api export --path /path/to/dir [--markdown]

Limitations

• Cannot edit notes containing images or attachments via the API.
• Interactive prompts require terminal access (use api subcommands for automation).

Notes

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