Apple Reminders

🚀 MCP Apple Reminders

An Model Context Protocol (MCP) server for interacting with the Apple Reminders app on macOS.

🚀 Quick Start

This is an MCP server designed to interact with the Apple Reminders app on macOS, offering a standardized interface for AI assistants to manage reminders.

✨ Features

• List Management: View all reminder lists in your Apple Reminders app.
• Get Reminders: Retrieve all reminders from a specific list.
• Create Reminders: Create new reminders with a title, due date, and notes.
• Complete Reminders: Mark reminders as completed.
• Delete Reminders: Remove reminders from a list.
• Date Handling: Properly handle ISO - formatted due dates.

📦 Installation

Integration with Claude Desktop

Add the following content to your claude_desktop_config.json file:

{
  "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"
      ]
    }
  }
}

💻 Usage Examples

Basic Usage

The server provides the following tools through MCP to interact with Apple Reminders:

getLists

Returns all reminder lists.

getReminders

Retrieves 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 of 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 be completed.

deleteReminder

Deletes a reminder.

• Parameters:
  • listName (Required): The name of the reminder list.
  • reminderName (Required): The name of the reminder to be deleted.

🔧 Technical Details

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.

📚 Documentation

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+.
• An Apple Reminders app with at least one configured list.

📄 License

MIT