A command-line tool for managing Apple Notes on macOS, enabling AI agents to create, search, and export notes via the memo utility.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install apple-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 apple-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 Apple Notes CLI?
The Apple Notes CLI skill provides a bridge between your terminal and the native macOS Notes application using the memo utility. By integrating this into Openclaw Skills, users can programmatically manage their personal knowledge base, making it an essential tool for developers who use Apple Notes as their primary capture system. This skill allows for seamless interaction with notes during AI-driven development workflows, ensuring that documentation and ideas are captured exactly where you need them.
Designed specifically for the macOS ecosystem, this skill respects system-level privacy and security while offering a robust interface for note manipulation. It transforms Apple Notes from a static app into a dynamic part of your automated environment, allowing for advanced operations like folder migration and bulk exports to developer-friendly formats.
Apple Notes CLI Use Cases
- Automatically saving code snippets or project summaries into specific Apple Notes folders during development.
- Using fuzzy search to quickly retrieve information from a vast collection of notes via an AI assistant.
- Exporting project-related notes to Markdown for inclusion in GitHub repositories or documentation sites.
- Organizing disorganized notes by moving them between folders through simple AI commands.
- Capturing meeting transcripts or logs directly into the macOS native notes ecosystem using Openclaw Skills.
How Apple Notes CLI Works
- The skill interfaces with the local macOS Apple Notes database via the memo command-line tool.
- When a command is issued, it queries the Notes.app library to list, filter, or search for specific entries.
- Creation tasks trigger either a quick-add title function or an interactive editor session for more detailed input.
- Management operations like moving or deleting notes utilize specific identifiers to ensure the correct note is targeted within the folder hierarchy.
- The export function invokes the Mistune library to convert internal note formats into clean Markdown or HTML files.
- All actions are synchronized in real-time with the Apple Notes application, ensuring consistency across all your devices via iCloud.
Apple Notes CLI Setup
To integrate this skill with your Openclaw Skills setup, you must first install the memo utility on a macOS system.
# Install via Homebrew
brew tap antoniorodr/memo && brew install antoniorodr/memo/memo
# Manual installation via pip
git clone https://github.com/antoniorodr/memo
cd memo
pip install .
Note: You must grant Terminal or your AI IDE permission to control Notes.app under System Settings > Privacy & Security > Automation.
Apple Notes CLI Data Schema & Taxonomy
The skill interacts with the Apple Notes schema, prioritizing text-based content and metadata. The following table describes the data handling:
| Element | Description |
|---|---|
| Note Title | The first line or designated title of the note used for identification. |
| Folder Name | The container folder in Apple Notes used for organizational filtering. |
| Body Text | The textual content of the note, excluding images or complex attachments. |
| Metadata | Includes creation dates and folder paths used during search and move operations. |
Exported files are generated as standardized .md or .html documents depending on the user's preference.
Apple Notes CLI Advanced Features
- Powerful fuzzy search for identifying notes without needing exact title matches.
- Multi-folder support allowing for complex organizational logic through Openclaw Skills.
- Automated Markdown export for seamless integration into static site generators or other PKM tools.
- Interactive terminal mode for editing existing notes without leaving the command-line interface.
- Local-first processing ensuring that all note interactions remain secure within the macOS environment.
SKILL.md
Loading
Related Openclaw Skills
1Password CLI Integration
A specialized skill for AI agents to securely install, authenticate, and manage credentials using the 1Password CLI.
GoalGetter
GoalGetter is a local-first task and habit tracking system that uses simple markdown files to manage your daily workflow and long-term goals.
Sleek Mobile App Design
An AI-driven skill for designing mobile app screens and managing UI projects through simple natural language commands.
COMMS.md Creator
A guided workflow to generate a structured personal communication manual that both humans and AI agents can query.
Apple Reminders CLI
A robust command-line interface for managing Apple Reminders on macOS using the remindctl utility.
Bear Notes
A specialized tool for managing Bear notes on macOS through the grizzly CLI and x-callback-url integration.
Featured*
