apple-notes

What This Skill Does

The apple-notes skill integrates OpenClaw with the macOS Notes.app via the memo CLI utility. This bridge allows the AI agent to perform full lifecycle management of your notes directly from the terminal or through natural language commands. Whether you are capturing quick ideas, organizing research into folders, or archiving thoughts for later, this skill serves as an interface between OpenClaw and the native macOS productivity environment. It supports creating, reading, updating, deleting (CRUD), searching, and exporting notes in markdown or HTML formats, making it an essential tool for users who rely on Apple Notes for information management.

Installation

To install this skill, use the Clawhub CLI within your terminal: clawhub install openclaw/skills/skills/steipete/apple-notes. Ensure you have the memo CLI installed on your system. You can install it via Homebrew using brew tap antoniorodr/memo && brew install antoniorodr/memo/memo. Once installed, ensure that your terminal environment has proper Automation permissions in System Settings > Privacy & Security > Automation to allow the agent to interact with the Notes.app.

Use Cases

This skill is perfect for users who want to stay focused within their workflow without manually opening the Notes app. Common use cases include: quickly logging tasks while coding, searching through archived meeting notes using fuzzy search, organizing project-specific documentation into designated folders, and exporting notes to Markdown for documentation or web publishing. It is particularly effective for users who prefer text-based control over graphical interfaces.

Example Prompts

1. "OpenClaw, create a new note titled 'Project Ideas' and add a list of items to it."
2. "Search my notes for anything related to 'quarterly budget' and summarize the findings."
3. "Move the note titled 'Shopping List' into the 'Personal' folder for me."

Tips & Limitations

When using this skill, keep in mind that it is strictly for macOS environments and requires the Apple Notes application to be active. Interactive commands like -a or -e will prompt the terminal for input, so ensure your agent has terminal focus. Note that the current implementation cannot edit or process notes that contain images, drawings, or heavy file attachments. For complex notes, standard text content is best. Always verify that your system permissions for Automation are enabled, as lack of access will prevent the agent from communicating with the underlying Apple APIs.