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)

License

MIT

remainders-mcp