A
licenseNot graded
qualityD
maintenanceEnables management of Apple Reminders on macOS, including creating, updating, and querying reminders with due dates, priorities, and completion status across different reminder lists.
MIT
reminders-mcp
by burghr
Provides tools for reading and managing local Apple Reminders on macOS via EventKit, including listing reminder lists, retrieving reminders, creating reminders, updating reminder details, completing or reopening reminders, and deleting reminders.
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-mcpremind me to buy groceries tomorrow at 5pm"
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
An MCP server that reads and changes the local Apple Reminders on this Mac. It
copies the structure of cal-mcp, and it uses EventKit through PyObjC.
Transport: streamable HTTP at
http://127.0.0.1:8002/mcpPort 8002 keeps it clear of other local MCP servers on 8000 and 8001
The server writes. It creates, changes, and deletes reminders.
Tools
Tool | Purpose |
| Test the connection. |
| Show every list, its account, and the default list. |
| Read reminders. Filter by list, due date, text, or completion. |
| Add one reminder, with a due date, notes, and priority. |
| Change the title, due date, notes, priority, list, or state. |
| Mark one reminder done, or reopen it. |
| Delete one reminder. This cannot be undone. |
Every tool except create_reminder and the two list tools needs the id that
get_reminders returns.
Related MCP server: Reminders MCP Server
Two lists can share a title
Two accounts can each hold a list named Tasks, for example a work account and
a personal account. A write tool refuses an ambiguous title and names the
choices. Send the account too, in the form Work/Tasks.
Install
python3 -m venv .venv
.venv/bin/pip install -r requirements.txtRun
.venv/bin/python server.pyThe launchd agent starts it at login and restarts it on failure. The file holds
the placeholder /Users/YOUR-USER, so replace it with your own home folder:
cp com.burghr.reminders-mcp.plist ~/Library/LaunchAgents/
sed -i '' "s|/Users/YOUR-USER|$HOME|g" ~/Library/LaunchAgents/com.burghr.reminders-mcp.plist
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.burghr.reminders-mcp.plistThe log goes to ~/Library/Logs/reminders-mcp.log.
Access
macOS binds the Reminders grant to the program that starts the server, not to
server.py. A start from a different program raises a new prompt. Open System
Settings, then Privacy & Security, then Reminders, to see or change the grant.
Read-only mode
Set REMINDERS_READONLY=1 in the environment to refuse every write. The read
tools keep working.
Related MCP Connectors
MCP connector for Apple Reminders — search, create, complete, and edit via your own Mac.
Read teams, spaces, lists and tasks; create, update and comment on tasks and track time.
Read tasks, habits, events and scheduling links; create and update Reclaim tasks and habits.
Context-aware reminders that surface when your situation matches, not at a fixed time.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables interaction with macOS Reminders app through AppleScript, allowing users to create, read, update, and delete reminders and lists, with support for filtering, batch operations, and reminder properties like priority and due dates.137 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Apple Reminders lists and reminders on macOS, including creating, updating, completing, and deleting reminders.789 npm5MIT
- FlicenseNot gradedqualityCmaintenanceEnables reading, creating, updating, and deleting Apple Reminders directly on macOS via the EventKit framework.-