Apple Reminders

@mgcrea/mcp-apple-reminders

Model Context Protocol server for the macOS Apple Reminders app.

Unofficial. Not affiliated with Apple. It drives the Reminders app that is already on your Mac.

Two lanes

• Apple Events lane — accounts, lists, reminders, and every mutation. Reminders' scripting dictionary is complete enough that this alone is a working server.
• Index lane — read-only SQLite over the Group Containers store, for the things the dictionary does not expose. Needs Full Disk Access.

Like Notes and unlike Mail, the Apple Events lane alone is usable. You can install this, use it, and only then decide whether to grant Full Disk Access. apple_reminders_diagnostics tells you which lane is answering.

Neither is granted to Reminders.app — it is the reader that needs permission. Grant it to whatever launches the server (Terminal, iTerm, VS Code, Claude), then restart it.

Tools

Read: diagnostics, list_accounts, list_lists, list_reminders, search_reminders, get_reminder.

Write, registered only when APPLE_REMINDERS_ALLOW_WRITES=1 — with the flag off they are invisible to the model, not merely refused: create_reminder, update_reminder, complete_reminders, move_reminders, delete_reminders.

Configuration

Notes that will bite you

• ~/Library/Reminders does not exist. Reminders lives under ~/Library/Group Containers/group.com.apple.reminders/. The path commonly cited elsewhere is wrong on a current macOS.
• Writes always go through Apple Events, never the store. The Reminders app holds the SQLite file open and reconciles it against a server, so writing to it corrupts sync state.
• Completed reminders are excluded by default. A search that "loses" a reminder has usually just found it completed; set APPLE_REMINDERS_INCLUDE_COMPLETED=1.

Licence

MIT.