Skip to main content
Glama

πŸ–ŠοΈ reminders-mcp

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)

Related MCP server: Apple Reminders MCP Server

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

Available Tools

6 tools
complete_reminderA

Mark a reminder as completed.

Args: name: The exact name of the reminder to complete. list_name: Optional list name to narrow the search.

Returns: True if the reminder was found and completed, False otherwise.

Inputs: name (required), list_name. Returns: result

create_reminderA

Create a new reminder in the macOS Reminders app.

Args: name: The title of the reminder. list_name: The list to add the reminder to. Uses the default list if empty. due_date: Optional due date, e.g. "February 28, 2026 at 9:00 AM". notes: Optional notes/body for the reminder.

Returns: The name of the created reminder.

Inputs: name (required), notes, due_date, list_name. Returns: result

delete_reminderA

Delete a reminder permanently.

Args: name: The exact name of the reminder to delete. list_name: Optional list name to narrow the search.

Returns: True if the reminder was found and deleted, False otherwise.

Inputs: name (required), list_name. Returns: result

list_reminder_listsA

List all reminder lists available in the macOS Reminders app.

Inputs: no named parameters. Returns: result

list_remindersA

List reminders from the macOS Reminders app.

Args: list_name: Optional name of a specific list to filter by. Leave empty for all lists. include_completed: Whether to include completed reminders (default: False).

Inputs: list_name, include_completed. Returns: result

update_reminderA

Update properties of an existing reminder.

Args: name: The exact current name of the reminder to update. list_name: Optional list name to narrow the search. new_name: New title for the reminder. Leave empty to keep unchanged. notes: New notes/description. Leave empty to keep unchanged. due_date: New due date, e.g. "February 28, 2026 at 9:00 AM". Leave empty to keep unchanged.

Returns: True if the reminder was found and updated, False otherwise.

Inputs: name (required), notes, due_date, new_name, +1 more. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool maps to a distinct action and resource: lists vs reminders, and create/update/complete/delete are clearly separated. No overlap in purpose.

    Naming Consistency5/5

    All six tools follow a consistent verb_noun pattern (list_, create_, update_, complete_, delete_), making the API predictable and easy to navigate.

    Tool Count5/5

    With 6 tools, the server is well-scoped for a reminders appβ€”covering listing, creation, update, completion, and deletion without bloat or missing essentials.

    Completeness4/5

    The lifecycle is well-covered, but there is no way to uncomplete a reminder or fetch a single reminder by ID. List with filtering mitigates this, but a status-reversal would round out the surface.

    Related MCP Connectors

    Related MCP Servers