Skip to main content
MCP server CX Codex

Apple Reminders · mgcrea — Claude Code MCP server: what it does, how to install

Apple Reminders — an MCP server that connects Claude Code to the macOS Reminders app: reads lists and tasks, creates and moves reminders, searches by text.

MIT ★ 6 updated 2026-10-22

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env APPLE_REMINDERS_ALLOW_WRITES=<APPLE_REMINDERS_ALLOW_WRITES> --env APPLE_REMINDERS_LISTS=<APPLE_REMINDERS_LISTS> --env APPLE_REMINDERS_ACCOUNTS=<APPLE_REMINDERS_ACCOUNTS> --transport stdio reminders -- npx -y @mgcrea/mcp-apple-reminders
Open on GitHub

What Apple Reminders does

The server exposes lists and reminders through two mechanisms. The main one uses Apple Events for accounts, lists, tasks and mutations. The supplementary one reads the SQLite store at ~/Library/Group Containers/group.com.apple.reminders/ for tags and attachments, which the scripting dictionary does not expose. Write operations require APPLE_REMINDERS_ALLOW_WRITES=1; without it the agent sees only read commands.

Without Full Disk Access the server runs on the Apple Events lane; tags and attachments remain hidden. The diagnostics utility reports which mechanism is active. Completed tasks are excluded by default; set APPLE_REMINDERS_INCLUDE_COMPLETED=1 to see them.

Writes always go through Apple Events because the Reminders app keeps the database open and reconciles it with a server, so direct writes corrupt sync state. Grant automation permission not to Reminders.app itself, but to the program that launches the server — the terminal, editor or Claude Code.

What it helps with

  • read task lists from the macOS Reminders app
  • search reminders by text or due date
  • create a task in a specific list through the agent
  • mark multiple reminders as complete
  • move tasks between lists

Example prompts for the agent

  • Show all tasks from the Work list due by the end of the week
  • Create a reminder to call the client tomorrow at 10 AM
  • Mark all tasks containing the word report as complete

How to install Apple Reminders

Platform CLI

claude mcp add --env APPLE_REMINDERS_ALLOW_WRITES=<APPLE_REMINDERS_ALLOW_WRITES> --env APPLE_REMINDERS_LISTS=<APPLE_REMINDERS_LISTS> --env APPLE_REMINDERS_ACCOUNTS=<APPLE_REMINDERS_ACCOUNTS> --transport stdio reminders -- npx -y @mgcrea/mcp-apple-reminders

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Apple Reminders

How to install Apple Reminders in Claude Code?

Run claude mcp add mcp-apple-reminders -- npx -y @mgcrea/mcp-apple-reminders. To enable writes, add --env APPLE_REMINDERS_ALLOW_WRITES=1 before the server name.

What does the Apple Reminders MCP server do?

It gives the agent access to lists and tasks from the macOS Reminders app: reading, searching, creating, updating and deleting reminders.

Why does Apple Reminders need Full Disk Access?

To read tags and attachments not exposed through the scripting dictionary. Without this permission the server still works, but those fields remain unavailable.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Apple Reminders by other authors comes first.

From the same set7

Project sponsors

Companies that keep this analytics open