# Apple Reminders

> Apple Reminders is an open-source MCP server for productivity. Local MCP server for Apple Reminders on macOS, with writes off by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Website:** https://cupertino.mgcrea.io
- **Repository:** https://github.com/mgcrea/cupertino/tree/HEAD/packages/reminders
- **MCP Registry name:** io.github.mgcrea/mcp-apple-reminders
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

Reads go through a read-only SQLite index of the Reminders store, while every change is sent through Apple Events so the app's own sync state is never touched. The write tools are only registered when `APPLE_REMINDERS_ALLOW_WRITES=1`, so with the flag off the model never sees that they exist.

Scope can be narrowed with allowlists for accounts and lists, and completed reminders stay hidden unless switched on. Full Disk Access is optional: without it the server still works over Apple Events, but tags and attachments are unavailable. A `diagnostics` tool reports which of the two paths is answering.

It is an unofficial package from the Cupertino family of Apple-app servers and is not affiliated with Apple.

## Features

- **Read-only by default:** Create, update, complete, move and delete tools stay unregistered until writes are enabled.
- **Account and list allowlists:** Environment variables limit every read and write to named accounts or lists.
- **Two access paths:** Apple Events cover lists and changes; an optional SQLite index adds tags and attachments.
- **Diagnostics tool:** Shows which access path is currently answering and what is missing.
- **Capped fallback reads:** Without the index, reads are capped at 500 reminders by default.

## Good for

- Ask an agent what is due this week across chosen lists
- Turn action items from a thread into dated reminders
- Search reminders by text without opening the app
- Limit an agent to a single work list while testing

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-apple-reminders -- npx -y @mgcrea/mcp-apple-reminders
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-reminders"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-reminders"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-apple-reminders": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-reminders"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-reminders"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-reminders"
      ]
    }
  }
}
```

## Tools

- `diagnostics`: Reports which access lane is answering
- `list_accounts`: Lists Reminders accounts
- `list_lists`: Lists reminder lists
- `list_reminders`: Lists reminders
- `search_reminders`: Searches reminders
- `get_reminder`: Reads one reminder
- `create_reminder`: Creates a reminder (writes only)
- `update_reminder`: Updates a reminder (writes only)
- `complete_reminders`: Marks reminders complete (writes only)
- `move_reminders`: Moves reminders between lists (writes only)
- `delete_reminders`: Deletes reminders (writes only)

## FAQ

### Does it need Full Disk Access?

Not to start. Automation permission for Reminders is required, while Full Disk Access only adds tags and attachments.

### Can the agent delete reminders?

Only if you set APPLE_REMINDERS_ALLOW_WRITES=1; otherwise delete and other write tools are not registered.

### Which macOS versions work?

The Cupertino site lists macOS 26 or later for its menu-bar app.

### Is it made by Apple?

No. The README states it is unofficial and not affiliated with Apple.

### Is Apple Reminders free?

Yes. Apple Reminders is open source, so you can use and self-host it for free.

### How do I add Apple Reminders to Claude Code?

Run this command in your terminal: claude mcp add mcp-apple-reminders -- npx -y @mgcrea/mcp-apple-reminders

### What are the best alternatives to Apple Reminders?

The closest alternatives to Apple Reminders are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/apple-reminders-3
