apple-notes-custom
Apple Notes.app integration for macOS. List folders, read, create, search, edit, and delete notes via AppleScript.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/shad0wca7/apple-notes-applescriptApple Notes
Interact with Notes.app via AppleScript. Run scripts from: cd {baseDir}
Commands
| Command | Usage |
|---|---|
| List folders | scripts/notes-folders.sh [--tree] [--counts] |
| List notes | scripts/notes-list.sh [folder] [limit] |
| Read note | scripts/notes-read.sh <name-or-id> [folder] |
| Create note | scripts/notes-create.sh <folder> <title> [body] |
| Search notes | scripts/notes-search.sh <query> [folder] [limit] [--title-only] |
| Edit note | scripts/notes-edit.sh <name-or-id> <new-body> [folder] |
| Delete note | scripts/notes-delete.sh <name> <folder> ⚠️ folder required |
Folder Paths
All commands support subfolder paths with / separator:
scripts/notes-list.sh "Scanned/Medical & Health" 10
scripts/notes-read.sh "blood test" "Scanned/Medical & Health"
scripts/notes-create.sh "Property/416 Garfield" "Inspection notes" "Roof looks good"
Folder Tree Structure
This collection has 4000+ notes. Key structure:
- Scanned — parent folder with many subfolders (Medical & Health, Receipts, etc.)
- Fetish — parent with subfolders (AW, Bimbo, Events, etc.)
- Hobbies — parent with subfolders (3d printing, Homelab, etc.)
- Property — subfolders per address
Use --tree --counts to see the full hierarchy.
Folder Listing
scripts/notes-folders.sh # Flat list
scripts/notes-folders.sh --counts # With note counts
scripts/notes-folders.sh --tree --counts # Full hierarchy with counts
Listing Notes
scripts/notes-list.sh "Notes" 10 # Specific folder
scripts/notes-list.sh "Scanned/Receipts" 5 # Subfolder
scripts/notes-list.sh "" 10 # All folders (shows folder name per note)
Without a folder, output includes the folder column: ID | Date | Folder | Title
With a folder: ID | Date | Title
Reading Notes
scripts/notes-read.sh "blood test" "Scanned/Medical & Health" # By name (partial match)
scripts/notes-read.sh "x-coredata://…/ICNote/p12345" # By ID (direct lookup, fast)
Output: Title, Folder, Modified date, ID, then body text.
Searching
Title search first (fast), body search fallback (slower):
scripts/notes-search.sh "tax" "" 10 # All folders
scripts/notes-search.sh "receipt" "Scanned/Receipts" 5 # Specific folder
scripts/notes-search.sh "keyword" "" 10 --title-only # Skip body search
Output: ID | Date | Folder | Title
Creating Notes
scripts/notes-create.sh "Notes" "My Title" "Body text here" # With body
scripts/notes-create.sh "Notes" "Empty Note" # Title only
Returns the created note's ID.
Editing Notes
scripts/notes-edit.sh "My Note" "New body content" "Notes" # By name
scripts/notes-edit.sh "x-coredata://…/ICNote/p12345" "New body" # By ID
Deleting 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-shad0wca7-apple-notes-applescript": {
"enabled": true,
"auto_update": true
}
}
}