Agent skill · operations · jeremylongshore
apple-notes-install-auth
Set up macOS automation access for Apple Notes via AppleScript, JXA,
Why this skill is useful
Adds a wrapper script for common Apple Notes operations and specific automation commands that the AI wouldn't reliably generate on its own.
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 Install & Auth Overview Apple Notes has no REST API. Automation uses macOS scripting technologies: AppleScript, JavaScript for Automation (JXA), Shortcuts, and the osascript command-line tool. No SDK to install — but you need macOS accessibility permissions. Prerequisites macOS 13+ (Ventura or later recommended) Terminal app or iTerm2 System Preferences > Privacy & Security > Automation permissions Instructions Step 1: Grant Automation Permissions Step 2: Verify JXA (JavaScript for Automation) Access Step 3: Create a Wrapper Script Step 4: Verify Shortcuts Integration Automation Technologies Technology Language Best For Docs ----------- ---------- ---------- ------ AppleScript AppleScript Simple operations Apple Scripting Guide JXA JavaScript Complex logic, JSON handling Apple JXA Reference osascript CLI wrapper Scripts, CI/CD man osascript Shortcuts Visual Non-developer workflows Shortcuts app PyXA Python Python automation pyxa.dev Output A recorded consent decision for the exact invoking app and macOS user A read-only, scoped authorization result (not a complete note listing) A wrapper that exposes only the approved operations and fails on unknown input An explicit decision on whether any Shortcuts workflow is approved Examples For a first-time setup, run one read-only count against the intended account and accept the macOS prompt in the interactive session. Do not use the list wrapper against a production account unless the task specifically requires metadata discovery; it can expose titles in terminal history and CI logs. For Shortcuts, use a non-production shortcut and a test note rather than a workflow that creates notes in a default account. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/apple-notes-install-auth--21f40c