Skip to content
MCP server

Apple Reminders

Local MCP server for Apple Reminders on macOS, with writes off by default

Runs locallyStatus and history
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
1.40.0
Listing updated
3 days ago

About Apple Reminders

Apple Reminders is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-reminders"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-reminders"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • APPLE_REMINDERS_ALLOW_WRITESRegister the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them.
  • APPLE_REMINDERS_LISTSRestrict every read and write to these Reminders lists, by name.
  • APPLE_REMINDERS_ACCOUNTSRestrict every read and write to these Reminders accounts, by name or id. Bounds reading, not just writing.

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

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)

What it does

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

Pricing

Open source

MIT-licensed server; the Cupertino companion app lists a 30-minute trial and 30-day refund, prices not published

Prices change. Check cupertino.mgcrea.io before you buy.

Apple Reminders 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 to Apple Reminders

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media