Log inSubmit server
MCP Server Apple Reminders logo

MCP Server Apple Reminders

by fradser

Manage macOS Reminders, reminder lists, subtasks, and Calendar events through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server 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": {
    "fradser-mcp-server-apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-apple-events"
      ]
    }
  }
}

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

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

fradser/mcp-server-apple-reminders connects MCP clients to native macOS Reminders and Calendar data through Apple’s EventKit framework. It provides tools for reading and modifying reminders, lists, checklist subtasks, calendar events, and calendar collections. Use it when an agent needs to manage personal tasks or time blocks on a Mac, with macOS permissions granted to the client host. The server runs over stdio and can be launched with the published npm package through npx.

Use cases

  • Create and update reminders from an MCP-enabled assistant
  • Organize tasks across macOS reminder lists
  • Track checklist subtasks inside reminders
  • Review calendar events within a date range
  • Create or modify calendar time blocks

Key features

  • CRUD operations for reminders and reminder lists
  • Checklist subtasks stored in reminder notes
  • CRUD operations for Calendar events
  • Calendar collection lookup with optional date filters
  • Filtering by dates, priority, tags, completion, and text
  • EventKit-based macOS integration

Tools5

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

Verified live~2.3k 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 1d ago

Recent health check succeeded.

20/20 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · mcp-server-apple-events (npm)

Adoption & maintenance

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

GitHub stars229Stargazers on the source repository.
npm downloads988Package downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Tools exposed5Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server Apple Reminders works

What fradser/mcp-server-apple-reminders MCP server does

fradser/mcp-server-apple-reminders exposes native macOS Reminders and Calendar data as MCP tools. Its backend uses the EventKit framework through a vendored Swift event command-line binary. Agents can inspect and change reminder tasks, reminder lists, subtasks, calendar events, and calendar collections without requiring a separate Homebrew installation of the backend.

Reminder operations cover creating, reading, updating, and deleting tasks and lists. Reminder data can include priorities, tags, due dates, completion state, recurring status, and location-related values when those values are returned by macOS. Subtasks act as checklist entries stored in a reminder’s notes and remain visible in the native Reminders application.

Calendar operations support CRUD actions for events and reading calendar collections. Calendar collection queries can be restricted by date range so an agent can find calendars containing events during a particular period.

How it works

The MCP process passes requests to the bundled EventKit CLI, which communicates with the macOS Reminders and Calendar frameworks. Date inputs support date-only values, timestamps with seconds, and ISO 8601 forms, with timezone-aware handling. Calendar events supplied with a date-only value are treated as all-day events.

The server returns structured results after processing natural-language requests through the connected MCP client. Native values configured in Reminders.app or Calendar.app can be returned when the corresponding records are read.

Setup and configuration

The published package requires Node.js 20 or newer and runs on macOS. With npx, install and start it using:

Terminal
npx mcp-server-apple-events

For a source build, pnpm and Xcode Command Line Tools are needed. The package includes a prebuilt universal, code-signed bin/event binary, so npx users do not need a Swift toolchain.

Configure the server as a stdio MCP server. Cursor and Claude Desktop examples use npx -y mcp-server-apple-events; a local checkout can instead launch dist/index.js with Node.js. Restart the MCP client after changing its configuration.

macOS permissions must be granted separately to each application that launches the server under System Settings > Privacy & Security > Reminders and Calendars. A permission granted to a terminal does not automatically authorize a desktop MCP client. Hosts must support EventKit permission requests and provide the required usage descriptions.

Tools and capabilities

  • reminders_tasks: Read, create, update, and delete reminders; supports filtering by completion, dates, priority, tags, text, recurrence, and location-related criteria.
  • reminders_lists: Read, create, update, and delete reminder lists.
  • reminders_subtasks: Create and manage checklist items stored in reminder notes.
  • calendar_events: Read, create, update, and delete calendar events.
  • calendar_calendars: Read available calendar collections, optionally filtered by an event date range.

Alarms, recurrence rules, location triggers, event URLs, structured locations, availability, and all-day settings have read-only behavior through the relevant tools. Configure those fields directly in Reminders.app or Calendar.app.

Limitations and notes

This server depends on macOS EventKit and cannot run as a native Windows or Linux integration. A headless or launchd context may be unable to display the macOS permission prompt; the server terminates an EventKit call after 30 seconds by default. EVENTKIT_CLI_TIMEOUT_MS can adjust that limit, while EVENT_PERMISSION_TIMEOUT_MS controls the bundled CLI’s permission wait. Invalid or zero timeout values use the default behavior, and the outer timeout cannot be disabled.

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 MCP Server Apple Reminders

fradser/mcp-server-apple-reminders is an MCP server that connects AI clients to macOS Reminders and Calendar through EventKit. Its main tools manage reminder tasks, reminder lists, subtasks, calendar events, and calendar collections, including reading, creating, updating, and deleting supported records.

Install and launch it with `npx mcp-server-apple-events`. Node.js 20 or newer and macOS are required. The published package includes the EventKit command-line binary, so npx users do not need to install Homebrew, Swift, or Xcode Command Line Tools.

Add a stdio server using command `npx` and arguments `-y mcp-server-apple-events` in Claude Desktop’s MCP configuration. Restart Claude Desktop completely after saving the file, then grant the application access to Reminders and Calendars in macOS privacy settings.

Yes, it works with Cursor through a stdio MCP configuration. Add a server whose command is `npx` and whose arguments are `-y mcp-server-apple-events`, then authorize Cursor under macOS Privacy & Security settings for Reminders and Calendars.

No, recurrence rules are read-only through this server. Recurrence settings, along with reminder alarms and location triggers, must be configured in Reminders.app or Calendar.app; the server can read those values when supported by macOS.

Related MCP servers

All in Browser Automation 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 PreviewMCP Server Apple Reminders AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/fradser-mcp-server-apple-reminders?style=directory)](https://allmcps.com/mcp/fradser-mcp-server-apple-reminders)
HTML Embed
<a href="https://allmcps.com/mcp/fradser-mcp-server-apple-reminders"><img src="https://allmcps.com/api/badge/fradser-mcp-server-apple-reminders?style=directory" alt="MCP Server Apple Reminders on AllMCPs" /></a>