macos-notes

What This Skill Does

The macos-notes skill provides a powerful bridge between the OpenClaw AI agent and Apple Notes, the native note-taking application on macOS. By leveraging AppleScript under the hood, the skill allows you to programmatically create, read, search, and manage your notes without ever leaving your terminal or AI conversation window. It is designed to handle both simple plain-text notes and complex HTML-formatted content. Whether you are capturing quick ideas, storing snippets of code, or maintaining detailed meeting logs, this skill ensures your information is organized and accessible within your existing note-taking workflow.

Installation

To integrate this skill into your environment, use the OpenClaw CLI to install it from the main repository. Run the following command in your terminal: clawhub install openclaw/skills/skills/lucaperret/macos-notes Ensure that you have permissions granted for the terminal to control Apple Notes if prompted by the system during your first execution.

Use Cases

This skill is ideal for users who rely on Apple Notes as their primary knowledge base. Common scenarios include:

• Capturing Context: Instantly save snippets, API keys, or research findings while in the middle of a development task.
• Search & Retrieval: Quickly find specific information buried in your notes by querying titles, which is much faster than manual scrolling.
• Automation: Use the agent to batch create daily summaries or meeting templates automatically.
• Organization: Use the list-folders function to visualize your organizational structure and direct notes into specific account categories like 'Work' or 'Personal'.

Example Prompts

1. "Note this down: The database migration script should be run in a dry-run mode first to avoid data corruption."
2. "What did I write about my project requirements for the Q3 roadmap?"
3. "Show me all the notes in my 'Personal' folder so I can see what I have been tracking lately."

Tips & Limitations

Always start by running list-folders to ensure the agent knows exactly where your account and folder structures reside; this prevents 'folder not found' errors. Note that the skill operates on exact matches for titles when reading notes. If you are creating notes with complex formatting, you can utilize the html field instead of body to preserve specific styling or structure. The skill is strictly macOS-exclusive, as it relies on internal AppleScript hooks. For large volumes of notes, use the limit field in the search command to prevent flooding your terminal output.