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
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-remindersWhat 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-remindersReplace <…> with your own values
Platform CLI
codex mcp add reminders --env APPLE_REMINDERS_ALLOW_WRITES=<APPLE_REMINDERS_ALLOW_WRITES> --env APPLE_REMINDERS_LISTS=<APPLE_REMINDERS_LISTS> --env APPLE_REMINDERS_ACCOUNTS=<APPLE_REMINDERS_ACCOUNTS> -- npx -y @mgcrea/mcp-apple-remindersReplace <…> with your own values
Config file
{
"mcpServers": {
"reminders": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-reminders"
],
"env": {
"APPLE_REMINDERS_ALLOW_WRITES": "<APPLE_REMINDERS_ALLOW_WRITES>",
"APPLE_REMINDERS_LISTS": "<APPLE_REMINDERS_LISTS>",
"APPLE_REMINDERS_ACCOUNTS": "<APPLE_REMINDERS_ACCOUNTS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"reminders": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-reminders"
],
"env": {
"APPLE_REMINDERS_ALLOW_WRITES": "<APPLE_REMINDERS_ALLOW_WRITES>",
"APPLE_REMINDERS_LISTS": "<APPLE_REMINDERS_LISTS>",
"APPLE_REMINDERS_ACCOUNTS": "<APPLE_REMINDERS_ACCOUNTS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e APPLE_REMINDERS_ALLOW_WRITES=<APPLE_REMINDERS_ALLOW_WRITES> -e APPLE_REMINDERS_LISTS=<APPLE_REMINDERS_LISTS> -e APPLE_REMINDERS_ACCOUNTS=<APPLE_REMINDERS_ACCOUNTS> reminders npx -y @mgcrea/mcp-apple-remindersReplace <…> 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.