apple-reminders-mcp
Provides tools to manage Apple Reminders, including listing, creating, completing, deleting, and updating reminders across lists, with support for due dates, priorities, notes, and tags via AppleScript.
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., "@apple-reminders-mcp list 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.
apple-reminders-mcp
An MCP server that connects Claude Desktop to Apple Reminders on macOS via AppleScript.
Prerequisites
macOS
Node.js 18+
Related MCP server: Apple Reminders MCP Server
Installation
1. Add to Claude Desktop config
Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:
{
"mcpServers": {
"apple-reminders": {
"command": "npx",
"args": ["-y", "@kamk95/apple-reminders-mcp"]
}
}
}2. Restart Claude Desktop
The first time a reminder tool is used, macOS will prompt you to grant Reminders access — click Allow.
Manual install (alternative)
If you prefer to run from source:
git clone https://github.com/kamrenkennedy/apple-reminders-mcp.git
cd apple-reminders-mcp
npm installThen use this config instead:
{
"mcpServers": {
"apple-reminders": {
"command": "node",
"args": ["/absolute/path/to/apple-reminders-mcp/index.js"]
}
}
}Tools
list_reminders
List reminders across all lists or a specific one.
Parameter | Type | Description |
| string | Filter to a specific list (optional) |
| boolean | Include completed reminders (default: false) |
create_reminder
Create a new reminder.
Parameter | Type | Description |
| string | Required. Title of the reminder |
| string | Destination list (default: Reminders) — created if it doesn't exist |
| string | Due date in |
| string | Due time in |
| string |
|
| string | Body/notes text |
| string[] | Tags to attach |
complete_reminder
Mark a reminder as completed.
Parameter | Type | Description |
| string | Required. Exact name of the reminder |
| string | Narrow search to this list (optional) |
delete_reminder
Permanently delete a reminder.
Parameter | Type | Description |
| string | Required. Exact name of the reminder |
| string | Narrow search to this list (optional) |
update_reminder
Update any fields on an existing reminder. Only provided fields are changed.
If you update notes or tags individually, the other is preserved automatically.
Parameter | Type | Description |
| string | Required. Current name of the reminder |
| string | Current list to narrow the search |
| string | Rename the reminder |
| string | Move reminder to this list |
| string | New due date in |
| string | New due time in |
| boolean | Remove the due date entirely |
| string |
|
| string | Replace notes text |
| string[] | Replace tags |
Notes
Tags are stored inside the reminder's notes field as
[tags: tag1, tag2]since the native Reminders tags API is not accessible via AppleScript. They round-trip correctly through all tools.Reminders are matched by exact name. If you have duplicates across lists, pass
list_nameto disambiguate.
Available Tools
5 toolscomplete_reminderC
Mark a reminder as completed.
Inputs: name (required), list_name.
create_reminderB
Create a new reminder in Apple Reminders.
Inputs: name (required), tags, notes, due_date, +3 more.
delete_reminderB
Permanently delete a reminder.
Inputs: name (required), list_name.
list_remindersB
List reminders from Apple Reminders. Optionally filter by list name and include completed items.
Inputs: list_name, include_completed.
update_reminderA
Update fields on an existing reminder. Only provided fields are changed. If you update notes OR tags individually, the other is preserved automatically.
Inputs: name (required), tags, notes, due_date, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool addresses a distinct action on reminders: create, list, complete, update, and delete. There is no overlap or ambiguity between them.
All tools follow a consistent verb_noun pattern (e.g., create_reminder, delete_reminder), with verbs clearly indicating the operation.
With 5 tools, the set is well-scoped for managing reminders, covering core operations without unnecessary bloat.
CRUD operations are present along with a completion action. Missing a 'get single reminder' tool is a minor gap, but the set is largely complete for its domain.
Maintenance
Related MCP Connectors
MCP connector for Apple Reminders — search, create, complete, and edit via your own Mac.
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Persistent memory for AI assistants. Save once; recall from Claude, ChatGPT, or any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA macOS-only MCP server that exposes Apple Reminders to AI clients, enabling create, read, update, delete, search, and organization of reminders and lists through natural language.3MIT
- AlicenseNot gradedqualityDmaintenanceMCP server enabling AI assistants to create, read, list, and delete Apple Reminders on macOS via AppleScript.12Apache 2.0
- AlicenseAqualityDmaintenanceAn MCP server for managing Apple Reminders via remindctl on macOS, integrating with Claude Desktop and CoWork.103MIT
- AlicenseAqualityDmaintenanceAn MCP server that lets Claude read and write your Things 3 tasks on macOS via AppleScript.10MIT