apple-reminders-mcp

An MCP server that connects Claude Desktop to Apple Reminders on macOS via AppleScript.

Prerequisites

• macOS
• Node.js 18+
• Claude Desktop

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 install

Then 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
list_name	string	Filter to a specific list (optional)
include_completed	boolean	Include completed reminders (default: false)

create_reminder

Create a new reminder.

Parameter	Type	Description
name	string	Required. Title of the reminder
list_name	string	Destination list (default: Reminders) — created if it doesn't exist
due_date	string	Due date in YYYY-MM-DD format
due_time	string	Due time in HH:MM 24-hour format — requires due_date
priority	string	none / low / medium / high / urgent
notes	string	Body/notes text
tags	string[]	Tags to attach

complete_reminder

Mark a reminder as completed.

Parameter	Type	Description
name	string	Required. Exact name of the reminder
list_name	string	Narrow search to this list (optional)

delete_reminder

Permanently delete a reminder.

Parameter	Type	Description
name	string	Required. Exact name of the reminder
list_name	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
name	string	Required. Current name of the reminder
list_name	string	Current list to narrow the search
new_name	string	Rename the reminder
new_list_name	string	Move reminder to this list
due_date	string	New due date in YYYY-MM-DD format
due_time	string	New due time in HH:MM 24-hour format
clear_due_date	boolean	Remove the due date entirely
priority	string	none / low / medium / high / urgent
notes	string	Replace notes text
tags	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_name to disambiguate.