🖊️ reminders-mcp

macOS only — this server uses AppleScript to communicate with the macOS Reminders app.

A Model Context Protocol (MCP) server that lets Claude read and manage your macOS Reminders. Create, list, update, complete, and delete reminders directly from any MCP-compatible client such as Claude Desktop.

Requirements

• macOS
• Python 3.11+
• uv — install with curl -LsSf https://astral.sh/uv/install.sh | sh
• macOS Reminders app (you'll be prompted to grant Automation permission on first run)

Installation

git clone https://github.com/mhtb32/reminders-mcp.git
cd reminders-mcp
uv sync

Claude Desktop Setup

Add the following to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "🖊️ reminders": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uv",
      "args": ["run", "--directory", "/path/to/reminders-mcp", "reminders-mcp"]
    }
  }
}

Replace YOUR_USERNAME and /path/to/reminders-mcp with your actual values, then restart Claude Desktop.

Tools

Tool	Description
list_reminder_lists	Get all reminder list names
list_reminders	List reminders (with name, due date, notes, and completion status), optionally filtered by list
create_reminder	Create a reminder with optional due date and notes
update_reminder	Update the title, notes, or due date of an existing reminder
complete_reminder	Mark a reminder as completed
delete_reminder	Delete a reminder permanently

Example Usage

Once connected, you can ask Claude things like:

• "What are my reminders for today?"
• "Add a reminder to buy groceries tomorrow at 9am"
• "Update the notes on my 'Call dentist' reminder to include the phone number"
• "Rename my 'Pay rent' reminder to 'Pay rent + utilities'"
• "Mark the 'Call dentist' reminder as done"
• "Show me everything in my Work list"

How It Works

This server uses AppleScript to communicate with the macOS Reminders app. No data leaves your machine — everything runs locally.

Project Structure

reminders-mcp/
├── src/reminders_mcp/
│   ├── __init__.py
│   ├── reminders.py   # AppleScript interface to macOS Reminders
│   └── server.py      # MCP server (FastMCP)
├── pyproject.toml
├── uv.lock
└── README.md

License

MIT