reminders-mcp

An MCP (Model Context Protocol) server for managing Apple Reminders via the remindctl CLI on macOS. It is intended for Claude Desktop and Claude CoWork, which run sandboxed and cannot run remindctl directly; this server runs as a separate process and talks to remindctl for you.

Prerequisites

• macOS (Apple Reminders framework required)

• Node.js >= 18

• remindctl — install via Homebrew:

  brew install steipete/tap/remindctl

• On first run, grant Reminders access when macOS prompts. Check status with remindctl status, request access with remindctl authorize, or enable manually in System Settings > Privacy & Security > Reminders.

Related MCP server: Apple Reminders MCP Server

Tools

Installation

npm install -g reminders-mcp

Configuration

Edit claude_desktop_config.json (macOS):

• Path: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the MCP server (macOS only; the app uses Apple Reminders):

{
  "mcpServers": {
    "reminders-mcp": {
      "command": "reminders-mcp",
      "args": []
    }
  }
}

Restart Claude Desktop or CoWork. The reminders tools (e.g. status, show-reminders) should appear in the tool list.

Development

git clone https://github.com/mikakoivisto/reminders-mcp.git
cd reminders-mcp
npm install
npm run build

Run in watch mode during development:

npm run dev

Test the server directly (newline-separated JSON-RPC messages):

printf '%s\n%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | node dist/index.js

License

MIT