reminders-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@reminders-mcp show my reminders for today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ποΈ 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 | shmacOS 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 syncClaude 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 |
| Get all reminder list names |
| List reminders (with name, due date, notes, and completion status), optionally filtered by list |
| Create a reminder with optional due date and notes |
| Update the title, notes, or due date of an existing reminder |
| Mark a reminder as completed |
| 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.mdLicense
MIT
Available Tools
6 toolscomplete_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
Scored across 6 tools
Each tool maps to a distinct action and resource: lists vs reminders, and create/update/complete/delete are clearly separated. No overlap in purpose.
All six tools follow a consistent verb_noun pattern (list_, create_, update_, complete_, delete_), making the API predictable and easy to navigate.
With 6 tools, the server is well-scoped for a reminders appβcovering listing, creation, update, completion, and deletion without bloat or missing essentials.
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
MCP connector for Apple Reminders β search, create, complete, and edit via your own Mac.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Related MCP Servers
- FlicenseBqualityCmaintenanceEnables users to add tasks to Apple Reminders through natural language commands in Claude Desktop. It provides quick entry for reminders with support for due dates, lists, and notes.1-
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Apple Reminders lists and reminders on macOS, including creating, updating, completing, and deleting reminders.7138 npm5MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to read and search Apple Reminders tasks on macOS, including lists, incomplete/completed items, and keyword search, all locally without modifying data.138 npm1MIT
- AlicenseAqualityCmaintenanceEnables Claude to manage Apple Reminders on macOS, including creating, reading, updating, deleting, and searching reminders across multiple lists with due dates, priorities, and notes.6138 npm32MIT