# Apple Reminders

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: mgcrea
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mgcrea/cupertino/tree/HEAD/packages/reminders
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/mgcrea-apple-reminders

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `APPLE_REMINDERS_ALLOW_WRITES`, `APPLE_REMINDERS_LISTS`, `APPLE_REMINDERS_ACCOUNTS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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

### Codex

**Platform CLI**
```bash
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-reminders
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-reminders
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [apple-reminders](https://affpapa.org/en/nevibecode/skills/apple-reminders.md) — skill · 6100 installs
- [apple-bridges](https://affpapa.org/en/nevibecode/skills/apple-bridges.md) — skill · ★ 49 repo stars
- [managing-reminders](https://affpapa.org/en/nevibecode/skills/managing-reminders.md) — skill · 202 installs
- [reminders-for-macos](https://affpapa.org/en/nevibecode/plugins/reminders-for-macos.md) — plugin · ★ 12 repo stars
- [intents-mcp](https://affpapa.org/en/nevibecode/mcp/intents-mcp.md) — MCP server · ★ 7 repo stars
- [calendar-event-manager](https://affpapa.org/en/nevibecode/skills/calendar-event-manager.md) — skill · 214 installs

## Other versions with the same name
- [Apple Reminders · jonathanrreed](https://affpapa.org/en/nevibecode/mcp/apple-reminders.md) — ★ 35 repo stars

From the same set: [mgcrea/cupertino](https://affpapa.org/en/nevibecode/by/mgcrea/cupertino.md) — 7 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
