Skip to main content
Glama

reminders-mcp

MCP plugin exposing Apple Reminders to a Claude Code agent. Pure tool-based plugin (no channel events) — the agent calls these tools when it needs to view or modify reminders.

Used today by Mira on Luna for tracking Arshad's personal/work reminders that auto-sync to his iPhone via iCloud.

Tools

  • list_lists() — return all Reminders lists on the system (e.g., Luna, Work, Home).

  • list_reminders(list, include_completed?) — show reminders in a list (incomplete by default).

  • create_reminder(list, title, notes?, due_date?, priority?) — add a reminder.

  • complete_reminder(list, title) — mark a reminder done by list + title.

  • delete_reminder(list, title) — remove a reminder by list + title.

The plugin wraps macOS Reminders via AppleScript / osascript. Tools that mutate require the macOS Automation permission to be granted to the terminal running Claude Code.

Related MCP server: reminders-mcp

Requirements

  • macOS (Reminders.app + AppleScript)

  • iCloud signed in on the host (so reminders sync to Arshad's iPhone)

  • Bun runtime

  • Full Disk Access and Automation permissions for the terminal running Claude Code

Setup

bun install

Claude Code .mcp.json

{
  "mcpServers": {
    "reminders": {
      "type": "stdio",
      "command": "/Users/claudewala/.bun/bin/bun",
      "args": ["/Users/claudewala/luna-plugins/reminders-mcp/server.ts"],
      "alwaysLoad": true
    }
  }
}

No env vars needed — the plugin discovers Reminders lists at runtime.

Scope notes

  • Luna-only by design — iCloud Reminders is a macOS-native feature. Linux hosts (titan, ariel, dione, janus) can't access it.

  • Currently wired for Mira only. Other luna agents could use it if their workflow needs reminder management, but it's not in their default tool surface.

  • The iCloud-Reminders ↔ iPhone sync is one-way visibility — reminders created here show up on Arshad's iPhone within seconds, and vice versa.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers