playbooks

home / skills / openclaw / openclaw / apple-notes

apple-notes skill

/skills/apple-notes

This skill helps you manage Apple Notes via the memo CLI on macOS, enabling create, view, edit, delete, search, move, and export notes.

This is most likely a fork of the mh-apple-notes skill from openclaw
npx playbooks add skill openclaw/openclaw --skill apple-notes

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.0 KB
---
name: apple-notes
description: 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.
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

- 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.

Overview

This skill manages Apple Notes on macOS via the memo CLI. It lets you create, view, edit, delete, search, move, and export notes from the terminal while preserving your existing Notes.app data. Use it when you want fast, scriptable access to Apple Notes without opening the GUI.

How this skill works

The skill calls the memo notes command-line interface to interact with Apple Notes through macOS automation APIs. It lists notes, filters by folder, performs fuzzy searches, opens interactive editors for create/edit flows, and exports selected notes to HTML or Markdown. It requires the memo tool installed and Notes.app permission in System Settings > Privacy & Security > Automation.

When to use it

  • Add a quick note from the terminal or a script
  • Search or list notes without opening Notes.app
  • Move notes between folders or organize folders in bulk
  • Export notes to Markdown or HTML for publishing or backups
  • Automate note workflows in shell scripts or developer tools

Best practices

  • Install memo via Homebrew for easy updates: brew tap antoniorodr/memo && brew install antoniorodr/memo/memo
  • Grant Automation permission to Notes.app in System Settings before using the skill
  • Avoid editing notes that contain images or attachments; memo cannot modify those notes
  • Use interactive flags for safe selection (-e, -d, -m) and quick-add flags for scripts (-a "Title")
  • Test export output when converting to Markdown/HTML to ensure formatting meets your needs

Example use cases

  • Quickly capture meeting notes from a terminal session with memo notes -a
  • Search across all notes for a fuzzy match with memo notes -s "query"
  • Move a note into a project folder during a cleanup pass with memo notes -m
  • Export a project note to Markdown for publishing or version control with memo notes -ex
  • Script nightly backups of selected folders by listing and exporting matching notes

FAQ

What platforms does this skill support?

macOS only. It relies on Apple Notes.app and macOS automation.

How do I install memo?

Install via Homebrew: brew tap antoniorodr/memo && brew install antoniorodr/memo/memo. Manual install via pip is possible if you build from source.

Can I edit notes that include images or attachments?

No. Notes containing images or attachments cannot be edited by memo; you can view or export them but not modify their content.