managing-apple-notes
Manage Apple Notes from the terminal using the inotes CLI. Use when asked to list, read, create, edit, delete, or search notes in Notes.app on macOS.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/wangwalk/managing-apple-notesManaging Apple Notes with inotes
inotes is a macOS CLI for Apple Notes. It communicates with Notes.app via AppleScript and supports all CRUD operations plus search. Output defaults to a human-readable table; use --json for machine-readable output.
🔒 Privacy & Security
- ✅ Open source: Full source code at https://github.com/wangwalk/inotes
- ✅ Local-only: All operations run locally via AppleScript; no data leaves your machine
- ✅ No network calls:
inotesdoes not connect to any remote servers - ✅ Auditable install: Binary installed via Homebrew from signed release or GitHub Releases
- ✅ MIT Licensed: Free and open for inspection and contributions
- ⚠️ Requires macOS Automation permission for Notes.app (user grants via System Settings)
- 📦 Universal binary: Supports both Apple Silicon (arm64) and Intel (x86_64)
Prerequisites
System Requirements:
- macOS 14+ (Sonoma or later)
- Apple Notes.app (comes with macOS)
Install via Homebrew (recommended):
brew install wangwalk/tap/inotes
Verify installation:
inotes --version # Should show: 0.1.2
which inotes # Should be in /opt/homebrew/bin/ or /usr/local/bin/
Manual installation from GitHub Releases:
Download from GitHub Releases and verify SHA256:
curl -LO https://github.com/wangwalk/inotes/releases/download/v0.1.2/inotes-0.1.2-universal-apple-darwin.tar.gz
# Verify checksum from release notes
tar xzf inotes-0.1.2-universal-apple-darwin.tar.gz
sudo cp inotes /usr/local/bin/
sudo chmod +x /usr/local/bin/inotes
Check permission:
inotes status
If permission is denied, the user must enable Automation access for their terminal in System Settings > Privacy & Security > Automation > Notes.
Commands
List notes
inotes # recent iCloud notes (default)
inotes today # modified today
inotes show week # modified this week
inotes show all # all notes
inotes show --folder Work # notes in a specific folder
inotes show recent --limit 10 # limit results
List folders
inotes folders
List accounts
inotes accounts
Create a folder
inotes mkfolder "Projects"
inotes mkfolder "Work Notes" --account Exchange
Read a note
inotes read 1 # by index from last show output
inotes read A3F2 # by ID prefix (4+ characters)
Create a note
inotes add --title "Meeting Notes" --body "Action items" --folder Work
Edit a note
inotes edit 1 --title "Updated Title"
inotes edit 2 --body "New content" --folder Projects
Delete a note
inotes delete 1 # with confirmation
inotes delete 1 --force # skip confirmation
Search notes
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-wangwalk-managing-apple-notes": {
"enabled": true,
"auto_update": true
}
}
}