Your notes, one prompt away.

Full CRUD for macOS Notes.app from Claude Code. Create, read, update, and delete notes and folders with natural language.

Get started View on GitHub
1
Command
5
Object types
0
Config required

Everything Notes.app can do, Claude can do.

One /notes command covers every operation exposed by the AppleScript API.

📄

Notes

Create, read, update, and delete. Search by name, filter by shared or password-protected status. Read as plaintext or HTML.

📁

Folders

Create and delete folders. List notes within any folder. Organize across multiple accounts.

☁️

Accounts

List all synced accounts (iCloud, Google, etc.). Browse folders and notes per account. Find your default account.

📎

Attachments

List and count attachments on any note. View attachment names and metadata. Read-only access.

Supported operations

Everything the macOS Notes.app AppleScript API exposes.

Object Operation Supported
NotesCreate, Read, Update, Delete, List, Search✓
FoldersCreate, Delete, List✓
AccountsList, Default account✓
AttachmentsList, Count✓
FiltersShared notes, Password-protected notes✓

Install in 10 seconds.

No npm. No config. No restart.

Claude Code

# Add the marketplace and install
/plugin marketplace add jondwillis/notes-app-plugin
/plugin install notes-app@jondwillis

Or clone directly

git clone https://github.com/jondwillis/notes-app-plugin.git
claude --plugin-dir ./notes-app-plugin

Just say what you want.

Claude interprets your request and picks the right AppleScript operation.

/notes list my notes
List notes
/notes create a note called "Meeting Notes" with today's agenda
Create
/notes read "Shopping List"
Read
/notes update "Shopping List" to add milk and eggs
Update
/notes delete "Old Draft"
Delete
/notes create a folder called "Work" in my iCloud account
Folders
/notes show all shared notes
Filter
/notes show attachments on "Project Plan"
Attachments

FAQ

How does it work under the hood?

The plugin gives Claude a library of AppleScript templates. When you describe what you want, Claude picks the right template, fills in your parameters, and executes it via osascript. No intermediate server or API — it talks directly to Notes.app.

Will it open Notes.app on my screen?

AppleScript commands run in the background. Notes.app doesn't need to be open or visible. macOS will ask for automation permission the first time — grant it in System Settings > Privacy & Security > Automation.

Can it read my password-protected notes?

No. macOS blocks AppleScript from accessing the content of password-protected notes. The plugin can detect which notes are protected, but cannot read or modify their content.

What about pins, tags, and smart folders?

These features exist in the Notes.app GUI but are not exposed through the AppleScript API. The plugin covers everything the API supports — which is full CRUD for notes and folders, plus accounts, attachments, and filtering.

Does it work with iCloud and Google accounts?

Yes. The plugin can list all synced accounts and operate on notes/folders in any of them. You can specify which account to target, or let it use your default.

Is it safe? Can it accidentally delete my notes?

The plugin instructs Claude to always confirm before any destructive operation (deleting notes or folders). Claude will ask you to approve before executing a delete. The plugin's tool access is scoped to osascript only — it cannot run arbitrary shell commands.