apple-notes

steipete/clawdis

Create, view, edit, delete, search, move, and export Apple Notes from the terminal on macOS.

What is apple-notes?

Apple Notes CLI provides command-line access to Apple Notes.app on macOS via the memo tool. Use it to manage notes programmatically, search across folders, and export to HTML or Markdown formats.

List and filter notes by folder
Search notes with fuzzy matching
Create new notes interactively or with a title
Edit existing notes in your default editor
Delete notes with interactive confirmation
Move notes between folders

How to install apple-notes

npx skills add https://github.com/steipete/clawdis --skill apple-notes

Prerequisites

macOS (Darwin)
Apple Notes.app installed and accessible
memo CLI tool (install via Homebrew or pip)
Grant Automation access to Notes.app in System Settings > Privacy & Security > Automation

Claude Code

Cursor

Windsurf

Cline

How to use apple-notes

1.Install memo via Homebrew: `brew tap antoniorodr/memo && brew install antoniorodr/memo/memo`
2.List all notes: `memo notes`
3.Search notes: `memo notes -s "query"`
4.Create a note: `memo notes -a "Note Title"`
5.Edit a note: `memo notes -e` and select interactively
6.Move a note: `memo notes -m` and choose destination folder
7.Export a note: `memo notes -ex` to HTML or Markdown

Use cases

Good for

Automate note creation from scripts or agents
Search and retrieve notes without opening Notes.app
Export notes for backup or integration with other tools
Organize notes by moving them between folders programmatically
Bulk operations on notes from the command line

Who it's for

macOS developers and power users
Automation engineers building workflows
Anyone integrating Apple Notes into CLI-based systems

apple-notes FAQ

Does this work on Windows or Linux?

No, apple-notes is macOS-only and requires access to Apple Notes.app.

Can I edit notes with images or attachments?

No, the tool cannot edit notes containing images or attachments.

Do I need to grant permissions?

Yes, you must grant Automation access to Notes.app in System Settings > Privacy & Security > Automation.

Can I search notes across all folders?

Yes, use `memo notes -s "query"` to fuzzy search all notes, or filter by folder with `-f "Folder Name"`

What formats can I export to?

You can export notes to HTML or Markdown format using `memo notes -ex`.

Full instructions (SKILL.md)

Source of truth, from steipete/clawdis.

name: apple-notes description: "Create, view, edit, delete, search, move, or export Apple Notes via the memo CLI on macOS." homepage: https://github.com/antoniorodr/memo metadata: { "openclaw": { "emoji": "📝", "os": ["darwin"], "requires": { "bins": ["memo"] }, "install": [ { "id": "brew", "kind": "brew", "formula": "antoniorodr/memo/memo", "bins": ["memo"], "label": "Install memo via Homebrew", }, ], }, }

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