Log inSubmit server
Apple Reminders logo

Apple Reminders

Native macOS Reminders access over MCP with 13 tools for searching, scheduling, creating, updating, and completing reminders.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Apple Reminders

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@high5ventures/apple-reminders-mcp"
      ],
      "env": {
        "REMINDERS_BINARY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The apple-reminders MCP server connects AI clients to macOS Reminders through EventKit, exposing 13 tools for reading and changing reminder data. It supports list metadata, full-text search, due-date queries, and complete reminder lifecycle operations using stable IDs. Use it on a Mac when an agent needs direct access to local Apple Reminders rather than AppleScript-based automation. Claude Desktop, Claude Code, Cursor, Zed, and other MCP clients can run it through its bundle, plugin, or npm package.

Use cases

  • Check reminders due today across all lists
  • Search reminder text across the local database
  • Create scheduled reminders from natural-language requests
  • Review overdue items and mark them complete
  • Update or delete reminders by stable ID

Key features

  • 13 EventKit-backed MCP tools
  • Stable reminder UUIDs across sessions
  • Full-text and date-based reminder queries
  • Create, update, complete, and delete operations
  • Structured JSON responses with safety annotations
  • Local macOS operation without network I/O

Tools13

What Apple Reminders lets your agent do. Expand a tool for its parameters.

Self-reported~135 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · @high5ventures/apple-reminders-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads181Package downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Tools exposed13Callable tools this server registers over MCP.

How Apple Reminders works

What apple-reminders does

The apple-reminders MCP server gives MCP-compatible AI clients structured access to the macOS Reminders app. It uses Apple’s EventKit framework through a signed Swift binary rather than AppleScript or direct database scraping. The server can inspect reminder lists, find reminders by text, retrieve date-based views, and modify individual reminders.

Reminder identifiers are stable UUIDs that remain usable across sessions. Responses use a consistent JSON envelope: successful calls return status: "ok" with data, while failures return an error status, code, and message. The implementation is local and does not perform network I/O.

The package is intended for macOS 11 or later and supports both Apple Silicon and Intel Macs. The published release is signed and notarized by Apple.

How it works

An MCP client starts the server and communicates with the EventKit-backed binary. On the first request that needs Reminders access, macOS prompts the user for permission. That permission can later be changed in System Settings under Privacy & Security and Reminders.

Three distribution paths use the same binary and tool behavior:

  • A .mcpb bundle for Claude Desktop and Claude Cowork
  • A Claude Code plugin installed from the project’s marketplace
  • An npm package for other MCP clients, including clients configured with a standard stdio command

The implementation includes a 30-second ceiling for the Node wrapper and a 16 MB response payload limit. The project reports a full CRUD smoke test completing in under one second against a database containing more than 300 reminders.

Setup and configuration

For Claude Desktop, download apple-reminders.mcpb from a release, open it, and approve the installation dialog. Grant Reminders permission when the first tool call triggers the macOS prompt. Updating uses the same bundle installation flow.

Claude Code users can add the marketplace and install the plugin with:

text
/plugin marketplace add high5-ventures/apple-reminders-for-claude
/plugin install apple-reminders@high5-apple-reminders-for-claude

Reload Claude Code after adding the marketplace so the plugin becomes available.

For another MCP client, install the npm package globally and configure the apple-reminders-mcp command, or use npx -y @high5ventures/apple-reminders-mcp directly in the client’s MCP configuration. The npm distribution may require REMINDERS_BINARY to point to the absolute path of the reminders-eventkit executable when the client uses a non-standard setup. The bundle and Claude Code plugin set that value automatically.

Building from source requires macOS 11 or later, Xcode Command Line Tools, and Node.js 18 or later. The build script produces the EventKit binary, Claude Code skill, and Claude Desktop bundle; source builds are unsigned.

Tools and capabilities

The apple-reminders MCP server exposes 13 tools:

  • get_lists returns reminder lists with open and completed counts.
  • get_list_info retrieves metadata for a list by name or ID.
  • list_reminders lists open, completed, or all reminders in a list.
  • search_reminders performs full-text search across lists.
  • get_today, get_overdue, and get_scheduled provide date-based views.
  • get_reminder fetches one reminder by ID.
  • create_reminder creates a reminder.
  • update_reminder changes an existing reminder.
  • complete_reminder and uncomplete_reminder change completion state.
  • delete_reminder permanently removes a reminder.

Tools include read-only and destructive safety annotations so clients can distinguish queries from mutations and request confirmation where appropriate. Text containing umlauts, accents, CJK characters, and emoji is preserved.

Limitations and notes

This server requires a Mac running macOS 11 or later and access to the local Reminders database. It does not provide a remote or cross-platform Reminders service. Normal use requires no configuration, but macOS permission must be granted before reading or changing reminders. Deletion is permanent, so clients may treat that operation differently from ordinary updates.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Apple Reminders

apple-reminders is an MCP server that connects AI clients to the macOS Reminders app through Apple EventKit. Its main tools list and search reminders, show today’s, overdue, or scheduled items, and create, update, complete, uncomplete, or delete reminders using stable IDs.

Install it by opening the release `.mcpb` bundle in Claude Desktop, installing the Claude Code plugin, or configuring the npm package in another MCP client. The bundle requires macOS 11 or later, and macOS asks for Reminders permission on first use.

Yes, apple-reminders works with Cursor through the npm distribution and an MCP configuration. Install `@high5ventures/apple-reminders-mcp` globally and use the `apple-reminders-mcp` command, or configure Cursor to run it with `npx -y @high5ventures/apple-reminders-mcp`.

The apple-reminders MCP server requires macOS 11 or later. It supports both Apple Silicon and Intel Macs, and the published binary is signed and notarized.

Set `REMINDERS_BINARY` to the absolute path of the `reminders-eventkit` executable when using the npm server with a non-standard MCP client. The Claude Desktop bundle and Claude Code plugin set this variable automatically.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewApple Reminders AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/apple-reminders?style=directory)](https://allmcps.com/mcp/apple-reminders)
HTML Embed
<a href="https://allmcps.com/mcp/apple-reminders"><img src="https://allmcps.com/api/badge/apple-reminders?style=directory" alt="Apple Reminders on AllMCPs" /></a>