home / mcp / apple reminders mcp server
Provides an MCP interface to manage Apple Reminders lists and items on macOS.
Configuration
View docs{
"mcpServers": {
"shadowfax92-apple-reminders-mcp": {
"command": "node",
"args": [
"/path/to/mcp-apple-reminders/dist/index.js"
]
}
}
}You can manage Apple Reminders from a Model Context Protocol (MCP) server, letting your AI assistants list reminder lists, fetch reminders, create new ones, mark them complete, and delete them. It handles due dates in ISO format and provides a standardized interface to work with Apple Reminders on macOS.
With an MCP client, you can perform common reminder tasks across your Apple Reminders data. You can: view all reminder lists, fetch reminders from a specific list, create a new reminder with a title, optional due date, and notes; mark reminders as completed; and delete reminders. All due dates should be provided in ISO format for reliable interpretation.
Prerequisites you need before installing this server show up as macOS, Node.js 16 or newer, and an Apple Reminders configuration with at least one list.
Step 1: Ensure Node.js is installed on your system. Download and install Node.js 16+ from the official source for macOS.
Step 2: Install dependencies for the MCP server package in your project directory.
Step 3: Build the project so the runtime bundle is generated.
Step 4: Run the MCP server locally using the runtime entry point shown below.
Step 5: Alternatively, use the NPX approach described later to run the server without a local install.
{
"mcpServers": {
"apple-reminders": {
"command": "node",
"args": [
"/path/to/mcp-apple-reminders/dist/index.js"
]
}
}
}{
"mcpServers": {
"apple-reminders": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-apple-reminders"
]
}
}
}The server exposes a set of tools to interact with Apple Reminders. The available actions are getLists, getReminders, createReminder, completeReminder, and deleteReminder.
- Use getLists to retrieve all reminder lists in Apple Reminders. - Use getReminders with a listName to fetch all reminders from a specific list. - Use createReminder to add a new reminder with a required listName and title, and optional dueDate (in ISO format) and notes. - Use completeReminder to mark a reminder as completed, and deleteReminder to remove a reminder from a list. - Ensure dueDate strings follow the ISO date format if you include a due date.
The server is built with TypeScript and relies on the MCP SDK. To extend functionality, modify the tools in the source index and the underlying AppleScript logic that talks to the Reminders app.
Requires macOS to access Apple Reminders, Node.js 16+, and at least one configured Apple Reminders list.
License: MIT.
Returns all reminder lists from the Apple Reminders app.
Returns reminders from a specific list. Requires listName as a parameter.
Creates a new reminder with a required listName and title, with optional dueDate (ISO format) and notes.
Marks a specified reminder as completed, requiring listName and reminderName.
Deletes a specified reminder from a list, requiring listName and reminderName.