Reminders

This MCP (Model Context Protocol) server lets you interact with macOS Reminders through AppleScript, enabling you to manage lists and reminders from MCP clients. It provides a programmable interface to create, read, update, and delete reminders and their lists from outside macOS.

How to use

You connect to this server from an MCP client by registering a server configuration under the mcpServers section. The server exposes tools for listing, creating, updating, and deleting reminder lists and individual reminders. You can query reminders with filters, create new items, mark them complete, and perform batch operations to speed up management.

Common usage patterns include: creating a new reminder list, adding multiple reminders to a list, updating reminder properties such as due date or priority, and batch operations to set status across many reminders at once.

How to install

Prerequisites you need before installation:

• macOS

• Node.js version 18.0.0 or newer

• Access to the macOS Reminders app

Install the MCP server globally using npm

npm install -g reminders-mcp

Or run it directly without installing globally using npx

npx reminders-mcp

Configuration and usage notes

To integrate this MCP server with your MCP client, add a server entry under mcpServers with either a local stdio command or an executable command. The examples below show both approaches.

"mcpServers": {
  "reminders": {
    "command": "npx",
    "args": ["reminders-mcp"]
  }
}

If you prefer to reference a globally installed binary directly, you can run the server with the binary name and provide an empty argument list.

"mcpServers": {
  "reminders": {
    "command": "reminders-mcp",
    "args": []
  }
}

Notes on development and usage

During development or testing, you may clone the MCP server repository and run development scripts as needed. Typical commands include installing dependencies and starting in development mode.

Development flow example commands: clone the project, install dependencies, and run development server or inspector tools.

Available tools

list_reminder_lists

Fetch all reminder lists with their names, IDs, and item counts.

create_reminder_list

Create a new reminder list with a specified name.

delete_reminder_list

Delete a reminder list and remove all associated reminders.

rename_reminder_list

Rename an existing reminder list.

get_reminders

Retrieve reminders with optional filtering by list, status, priority, date range, or search term.

get_reminder

Fetch a single reminder by its ID.

create_reminder

Create a new reminder with properties such as title, notes, due date, and list.

update_reminder

Update properties of an existing reminder.

delete_reminder

Delete a specific reminder by its ID.

complete_reminder

Mark a reminder as completed or not completed.

batch_create_reminders

Create multiple reminders in a single operation (up to 100).

batch_update_reminders

Update multiple reminders in a single operation (up to 100).

batch_complete_reminders

Complete or uncomplete multiple reminders in one go (up to 100).