MCP Apple Reminders

A Model Context Protocol (MCP) server for interacting with Apple Reminders on macOS.

Features

List Management: View all reminder lists in your Apple Reminders app
Reminder Retrieval: Get all reminders from a specific list
Create Reminders: Create new reminders with titles, due dates, and notes
Complete Reminders: Mark reminders as completed
Delete Reminders: Remove reminders from your lists
Date Handling: Proper handling of ISO date formats for due dates

Configuration

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "apple-reminders": {
      "command": "node",
      "args": [
        "/path/to/mcp-apple-reminders/dist/index.js"
      ]
    }
  }
}

NPX (Coming Soon)

{
  "mcpServers": {
    "apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-apple-reminders"
      ]
    }
  }
}

API

The server exposes the following MCP tools for interacting with Apple Reminders:

getLists

Returns all reminder lists.

getReminders

Returns reminders from a specific list.

Parameters:
- listName (required): The name of the reminder list

createReminder

Creates a new reminder.

Parameters:
- listName (required): The name of the reminder list
- title (required): The title of the reminder
- dueDate (optional): The due date for the reminder (ISO format: "YYYY-MM-DDTHH:MM:SS.sssZ")
- notes (optional): Notes for the reminder

completeReminder

Marks a reminder as completed.

Parameters:
- listName (required): The name of the reminder list
- reminderName (required): The name of the reminder to complete

deleteReminder

Deletes a reminder.

Parameters:
- listName (required): The name of the reminder list
- reminderName (required): The name of the reminder to delete

How It Works

This MCP server uses AppleScript to interact with the Apple Reminders app on macOS. It provides a standardized interface for AI assistants to manage reminders through the Model Context Protocol.

Development

This project uses TypeScript and the MCP SDK. To extend functionality, modify the tools in src/index.ts and the AppleScript functions in src/reminders.ts.

Requirements

macOS (required for Apple Reminders integration)
Node.js 16+
Apple Reminders app configured with at least one list

License

MIT

Integrations