mac-notes-agent

What This Skill Does

The mac-notes-agent provides a bridge between your OpenClaw agent and the native Apple Notes application on macOS. By utilizing a lightweight Node.js CLI that executes AppleScript via osascript, the agent gains the ability to interact with your notes database without requiring third-party libraries or complex setups. It facilitates the complete lifecycle of note management, including creating, reading, updating, appending, deleting, and searching for information stored within Apple Notes. Whether you are capturing quick thoughts, organizing project documentation, or managing personal knowledge, this skill automates the process of maintaining your notes through conversational interaction.

Installation

To add this skill to your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/swancho/mac-notes-agent

Ensure that you are running on a macOS device, as this skill relies on the built-in AppleScript capabilities of the Notes app. No additional npm dependencies are required for this package, as it strictly utilizes Node.js built-in modules.

Use Cases

• Automated Logging: Automatically log meeting summaries, research findings, or code snippets directly into specific Apple Notes folders.
• Quick Retrieval: Query your notes for information during a conversation, such as "What was the meeting note about the project deadline?"
• Knowledge Management: Dynamically append new research to existing notes to keep your project documentation living and updated.
• Task Cleanup: Archive or remove outdated notes by interacting with the agent to clear your workspace.

Example Prompts

1. "Create a new note in the 'Project Ideas' folder titled 'OpenClaw Integration' with the body 'Explore API hooks for local file system access.'"
2. "Search my notes for any entries containing the keyword 'Q4 Roadmap' and summarize the findings for me."
3. "Append a new line to my 'Grocery List' note in the 'Personal' folder that says 'Buy milk and eggs.'"

Tips & Limitations

• Identification: Apple Notes lacks internal persistent UIDs. This agent uses a synthetic ID format (folderName::creationDate::title). If you have multiple notes with the identical title in one folder, the agent will prioritize the most recently created version.
• Rendering: While you can use newline characters (\n) for formatting, the agent internally converts these to <br> tags to ensure compatibility with Apple Notes' internal structure.
• Permissions: Ensure your terminal or OpenClaw runner has the necessary macOS accessibility permissions if prompted by the operating system to execute AppleScript commands.