playbooks

home / skills / openclaw / skills / mh-apple-notes

mh-apple-notes skill

/skills/mohdalhashemi98-hue/mh-apple-notes

This skill helps you manage Apple Notes from the terminal using memo, enabling you to create, view, search, move, and export notes efficiently.

npx playbooks add skill openclaw/skills --skill mh-apple-notes

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

Files (2)
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, letting you create, view, edit, delete, search, move, and export notes from the terminal. It integrates with the system Notes app and supports interactive and quick operations to streamline note workflows. Use it when you want fast terminal-based note management or to script Apple Notes tasks.

How this skill works

The skill invokes the memo notes subcommands to list, filter, search, add, edit, delete, move, and export notes. Many actions use interactive selection in the terminal; quick-add and search flags provide non-interactive shortcuts. Export options produce HTML or Markdown using a markdown processor for downstream use.

When to use it

  • Add or capture a new Apple Note from the terminal or a script.
  • Quickly list or search notes across all folders with fuzzy matching.
  • Edit or remove notes without opening the Notes app.
  • Move notes between folders to keep notes organized.
  • Export notes to HTML or Markdown for publishing or backup.

Best practices

  • Run on macOS with Notes.app accessible and grant Automation permission when prompted.
  • Use interactive mode for precise selection, and quick-add for scripted workflows.
  • Avoid editing notes that contain images or attachments; the tool cannot modify them.
  • Grant memo Automation permission via System Settings > Privacy & Security > Automation before automating.
  • Back up important notes before bulk delete or move operations.

Example use cases

  • Capture meeting notes quickly from the terminal using quick-add with a title.
  • Search all notes for a keyword with fuzzy search to find relevant content fast.
  • Batch export selected notes to Markdown for publication or archival.
  • Move notes into a project folder after completing a task.
  • Delete outdated notes interactively while preserving current work.

FAQ

Does this work on Windows or Linux?

No. This skill requires macOS and access to the Apple Notes app.

Can I edit notes that contain images or attachments?

No. Notes with images or attachments cannot be edited by the tool.