A Node.js and AppleScript bridge that enables AI agents to perform full CRUD operations on the native macOS Notes application.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mac-notes-agent
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mac-notes-agent using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Mac Notes Agent?
Mac Notes Agent is a dedicated utility designed to bridge the gap between AI automation and the native Apple Notes ecosystem on macOS. By utilizing a Node.js CLI that interfaces with AppleScript, this skill allows users to programmatically manage their personal knowledge base without leaving their development environment. As one of the more focused Openclaw Skills, it provides a reliable way to ensure that digital notes are synchronized, searchable, and actionable across various automated workflows.
Mac Notes Agent Use Cases
- Automatically documenting meeting notes and summaries directly into a specific Apple Notes folder.
- Appending recurring status updates or log entries to a daily work journal.
- Retrieving specific project information from a macOS knowledge base using search queries.
- Organizing research by programmatically creating folders and categorizing notes during browsing sessions.
How Mac Notes Agent Works
- The agent or user invokes a command through the Node.js CLI located in the skill directory.
- The CLI processes the input parameters and generates a corresponding AppleScript command.
- The system executes the script via the
osascriptutility to communicate with the macOS Notes app. - The Notes app performs the requested action (add, list, get, update, or delete) on the default account.
- The CLI captures the output and returns a structured JSON response back to the caller.
Mac Notes Agent Setup
To use this skill within your Openclaw Skills collection, ensure you are running macOS and have the Notes app configured.
Navigate to the skill directory and use the Node.js runner:
# List all notes in a specific folder
node skills/mac-notes-agent/cli.js list --folder "Work"
# Create a new note
node skills/mac-notes-agent/cli.js add --title "New Idea" --body "Details here"
Mac Notes Agent Data Schema & Taxonomy
The Mac Notes Agent uses a specific identification model to manage notes since Apple Notes does not provide stable persistent IDs via AppleScript.
| Property | Description |
|---|---|
| title | The primary identifier and headline of the note. |
| body | The content of the note, where newlines are converted to HTML line breaks for native rendering. |
| folder | The category or container for the note; created automatically if missing. |
| id | A synthetic key formatted as folderName::creationDate::title to help differentiate similar notes. |
Mac Notes Agent Advanced Features
- Smart Folder Creation: Automatically generates a new folder if the specified destination does not exist.
- Content Appending: Efficiently adds new text to the end of existing notes without overwriting data.
- Synthetic Identity Mapping: Uses a combination of folder name, creation date, and title to provide a unique reference for notes.
- Native Formatting Support: Translates standard text line breaks into HTML tags to maintain visual consistency within the Apple Notes app.
SKILL.md
Loading
Related Openclaw Skills
clawaifu - OpenClaw Waifu
An AI companion skill that generates situational anime-style selfies of the character Reze and delivers them directly to Telegram.
USDC Hackathon
A specialized skill enabling AI agents to build blockchain projects and vote in the USDC Hackathon on Moltbook.
USDC Hackathon
A specialized skill for AI agents to participate in the USDC Hackathon by building projects, submitting work to Moltbook, and voting on peer submissions.
USDC Hackathon Agent Skill
A comprehensive toolkit for AI agents to build, submit, and peer-review projects within the USDC Hackathon ecosystem on Moltbook.
Trip Calendar
Effortlessly sync flight itineraries, hotel bookings, and travel milestones directly to Google Calendar using CLI automation.
Trip Discover
An intelligent travel agent skill that recommends destinations based on vibe, budget, and group size using real-time data.
Featured*
