Apple Notes
Let a coding agent list, search, create, edit, and export your Apple Notes on macOS through the memo CLI.
Overview
Apple Notes is an agent skill for the Operate phase that manages Apple Notes through the memo CLI on macOS—create, search, move, and export without opening the Notes app.
Install
npx skills add https://github.com/steipete/clawdis --skill apple-notesWhat is this skill?
- Full CRUD via `memo notes` with folder filters and fuzzy search
- Quick create with title or interactive editor for longer notes
- Move notes between folders and export to HTML or Markdown
- Homebrew install path (`antoniorodr/memo/memo`) with macOS Notes.app Automation permission
- darwin-only; requires the `memo` binary on PATH
- Export targets include HTML and Markdown
Adoption & trust: 2.3k installs on skills.sh; 378k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You keep context in Apple Notes but your agent cannot read or update them without a macOS Automation bridge and a stable CLI.
Who is it for?
Solo macOS builders who centralize notes in Apple Notes and want shell- or agent-driven capture and search.
Skip if: Windows or Linux workflows, team wikis on Notion/Confluence only, or headless servers without Notes.app.
When should I use this skill?
Create, view, edit, delete, search, move, or export Apple Notes via the memo CLI on macOS.
What do I get? / Deliverables
After installing memo and granting Notes access, the agent runs documented `memo notes` commands to view, mutate, or export notes as HTML or Markdown from the terminal.
- Created or updated notes inside Apple Notes
- Exported note files in HTML or Markdown
Recommended Skills
Journey fit
Personal and ops notes are maintained continuously after you ship—this skill fits the Operate shelf as day-to-day capture and retrieval, not one-off launch content. Iterate covers tightening loops on what you wrote down: search, move folders, export to Markdown/HTML for reuse in docs or support.
How it compares
Local macOS CLI integration—not a cross-platform notes MCP or hosted PKM sync service.
Common Questions / FAQ
Who is apple-notes for?
Indie developers and operators on macOS who already use Apple Notes and want Claude Code, Cursor, or similar agents to manage notes via the memo CLI.
When should I use apple-notes?
Use it in Operate when iterating on personal runbooks, during Build when pulling note snippets into docs, or anytime on macOS you need terminal search, export, or quick capture into Notes.
Is apple-notes safe to install?
It shells out to a third-party Homebrew formula and needs Automation access to Notes.app; review the Security Audits panel on this page and only grant access if you trust the memo project.
SKILL.md
READMESKILL.md - Apple Notes
# 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.