Agent skill · software engineering · jeremylongshore
apple-notes-hello-world
Create, read, and list Apple Notes using JXA and AppleScript.
Why this skill is useful
Adds multiple executable scripts for creating, reading, and managing Apple Notes via JXA that are not commonly found in public documentation.
What it needs
Requires macos installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Apple Notes Hello World Overview Create, read, search, and delete Apple Notes using JXA (JavaScript for Automation) via osascript. All examples work from the command line on macOS. Prerequisites Completed apple-notes-install-auth (permissions granted) macOS with Notes.app Instructions Step 1: Create a Note Step 2: List All Notes Step 3: Read a Note's Content Step 4: Search Notes Step 5: Create Note in Specific Folder Step 6: Delete a Note Note Properties Property Type Writable Description ---------- ------ ---------- ------------- name string Yes Note title (first line) body string (HTML) Yes Full note content as HTML id string No Unique identifier creationDate Date No When note was created modificationDate Date No Last modification container Folder No Parent folder Output Created a note via JXA and AppleScript Listed, searched, and read note content Organized note into a folder Deleted a note Examples Create one synthetic note in a pre-created, test-only local folder, read only that note back by its returned identifier, and remove it after verifying the exercise. Do not list all notes, search a live account, or create folders implicitly as part of a permission smoke test. Error Handling Error Cause Solution ------- ------- ---------- Notes got an error Notes.app not running Add Notes.activate() first Empty body Note has no text content Check note is not just an image Can't make folder Folder already exists Check before creating Slow response iCloud sync in progress Wait for sync; use local account Resources AppleScript Notes Dictionary JXA Examples osascript Manual Next Steps Proceed to apple-notes-local-dev-loop for development workflow setup.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/apple-notes-hello-world