A bridge for AI agents to create, read, and search Apple Notes using AppleScript and Python-based automation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install macos-notes
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 macos-notes 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 macOS Notes?
The macOS Notes skill is a robust integration designed for Openclaw Skills that allows AI agents to interact directly with the native Apple Notes application. By leveraging osascript and a Python-powered JSON interface, this skill enables programmatic management of your local and iCloud notes. It serves as a vital tool for developers and power users who want to bridge the gap between their AI coding environment and their personal knowledge management system.
Whether you need to capture a fleeting thought, save a code snippet, or retrieve information from a past meeting, this skill provides a secure and structured way to handle your data. It focuses on reliability and privacy, ensuring that interactions with the Notes.app are logged and validated while maintaining the native user experience of the macOS ecosystem.
macOS Notes Use Cases
- Automating the creation of daily stand-up notes or meeting summaries directly from an AI prompt.
- Searching through technical documentation or snippets stored locally in Apple Notes.
- Organizing project-related notes into specific folders and accounts like iCloud.
- Reading note content to provide context for AI-driven development or research tasks.
- Quickly 'jotting down' ideas during a coding session without leaving the terminal or IDE.
How macOS Notes Works
- The AI agent identifies a note-related request and maps it to a specific command such as create-note, read-note, or list-notes.
- For organization-heavy tasks, the agent calls list-folders to discover the available account and folder structure on the machine.
- The agent prepares a JSON payload containing fields like title, body, or html and pipes it to the notes.sh script via standard input.
- A Python helper script parses the JSON to ensure data integrity and prepares the arguments for AppleScript.
- The script executes an osascript command that communicates with the macOS Notes.app API to perform the requested operation.
- The result is returned to the agent in a structured format, and the activity is recorded in a local log file for auditability.
macOS Notes Setup
To utilize this skill within Openclaw Skills, ensure you are on macOS with the Notes app installed.
# Ensure python3 and osascript are available
python3 --version
which osascript
# Initialize by listing your accounts and folders to verify connectivity
"$SKILL_DIR/scripts/notes.sh" list-folders
macOS Notes Data Schema & Taxonomy
The skill manages data using a structured JSON input that maps to the Notes.app hierarchy.
| Field | Type | Description |
|---|---|---|
| title | String | The heading of the note (mandatory for creation). |
| body | String | Plain text content; newlines are automatically converted to HTML breaks. |
| html | String | Raw HTML content for rich text support (overrides body). |
| account | String | The target account name (e.g., 'iCloud' or 'On My Mac'). |
| folder | String | The specific folder within the chosen account. |
| query | String | Used in search-notes to find text within note titles. |
macOS Notes Advanced Features
- Secure Input Handling: Uses stdin for JSON data to prevent sensitive note content from appearing in system process lists.
- Plain Text to HTML Conversion: Automatically transforms standard line breaks into HTML for consistent rendering in the Notes app.
- Multi-Account Awareness: Supports granular control over where notes are saved, differentiating between local and cloud-synced accounts.
- Detailed Logging: Maintains a timestamped log of all note interactions at logs/notes.log for transparency.
- Input Validation: Includes a robust validation layer to reject malformed data and prevent script failures.
SKILL.md
Loading
Related Openclaw Skills
macOS Calendar Management
A specialized skill for managing Apple Calendar events and schedules on macOS using natural language commands and programmatic AppleScript execution.
Snapmaker Printer Control
Control and monitor your Snapmaker U1 3D printer through AI-driven automation using the Moonraker API.
Apple TV Control
A comprehensive automation skill that enables AI agents to control Apple TV hardware via the pyatv library for media playback and app management.
Video Generator MCP
An automated video production skill that converts product titles, descriptions, and images into marketing short videos via MCP tools.
macOS Reminders
A specialized automation skill for managing macOS Reminders through natural language processing and AppleScript.
Drip Billing Integration
A robust integration for tracking AI agent execution costs and metered usage via the Drip SDK.
Featured*
