Which integrations are available for this server?

Provides tools for interacting with macOS Reminders app via AppleScript, enabling management of reminder lists and reminders including creation, updates, deletion, completion tracking, and batch operations.

How do I use Reminders MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Reminders MCP Server create a reminder 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 Server

An MCP (Model Context Protocol) server for interacting with macOS Reminders app via AppleScript.

Requirements

macOS
Node.js >= 18.0.0
Access to macOS Reminders app

Installation

npm install -g reminders-mcp

Or use directly with npx:

npx reminders-mcp

Usage

As an MCP Server

Add to your MCP client configuration:

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

Or if installed globally:

{
  "mcpServers": {
    "reminders": {
      "command": "reminders-mcp"
    }
  }
}

Development

git clone https://github.com/jagadeesh52423/remainders-mcp.git
cd remainders-mcp
npm install
npm run dev        # Run with tsx
npm run inspector  # Run with MCP inspector

Available Tools

Lists

Tool	Description
`list_reminder_lists`	Get all reminder lists with names, IDs, and counts
`create_reminder_list`	Create a new reminder list
`delete_reminder_list`	Delete a list and all its reminders
`rename_reminder_list`	Rename an existing list

Reminders

Tool	Description
`get_reminders`	Get reminders with filtering (list, status, priority, date range, search)
`get_reminder`	Get a single reminder by ID
`create_reminder`	Create a new reminder
`update_reminder`	Update reminder properties
`delete_reminder`	Delete a reminder
`complete_reminder`	Mark reminder as completed/incomplete

Batch Operations

Tool	Description
`batch_create_reminders`	Create multiple reminders at once (max 100)
`batch_update_reminders`	Update multiple reminders at once (max 100)
`batch_complete_reminders`	Complete/uncomplete multiple reminders (max 100)