MCP macOS Reminders Orchestrator

This Model Context Protocol (MCP) service bridges AI directives with the native Apple Reminders application running on macOS.

Key Capabilities

List Enumeration: Retrieve the full registry of existing reminder containers.
Task Fetching: Obtain all individual items residing within a specified list.
New Task Creation: Instantiate fresh reminders, supporting mandatory titles, optional detailed notes, and precise due dates (adhering strictly to ISO 8601 standards).
Task Finalization: Designate existing reminders as successfully completed.
Task Elimination: Permanently discard unwanted reminders.
Date Precision: Robust management and validation of scheduling information using the ISO date specification.

Deployment Instructions

Utilizing Claude Desktop

In your claude_desktop_config.json, incorporate the following configuration block:

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

NPX Distribution (Future Availability)

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

Exposed Remote Procedures (API)

This server exposes the following functions for remote invocation through the MCP framework:

getContainerInventory

Retrieves a catalog of all available reminder lists.

retrieveTasksFromContainer

Fetches the complete set of tasks associated with a given list. - Arguments: - containerName (Mandatory): The identifier string for the target reminder list.

enqueueNewTask

Provisions a new task item. - Arguments: - containerName (Mandatory): The target list for the new item. - taskLabel (Mandatory): The descriptive title of the reminder. - scheduledCompletionTime (Optional): The deadline, formatted as ISO 8601: YYYY-MM-DDTHH:MM:SS.sssZ. - annotations (Optional): Supplementary descriptive text attached to the reminder.

markTaskAsFulfilled

Sets the completion status of a specified task to 'done'. - Arguments: - containerName (Mandatory): The list containing the target task. - taskIdentifier (Mandatory): The name or unique identifier of the task to finalize.

purgeTaskEntry

Removes a specified task from its list permanently. - Arguments: - containerName (Mandatory): The list housing the task slated for removal. - taskIdentifier (Mandatory): The name or unique identifier of the task to delete.

Operational Mechanics

This service leverages AppleScript commands executed directly against the host macOS operating system to interface with the native Reminders application. It standardizes this low-level access into a consistent, protocol-driven interface suitable for advanced automation agents.

Development Notes

This component is constructed using TypeScript and the MCP SDK. Enhancements or modifications to the service methods should target src/index.ts for tool definition changes, and src/reminders.ts for the underlying AppleScript logic.

Prerequisites

Operating System: macOS (essential for Apple Reminders functionality).
Runtime Environment: Node.js version 16 or newer.
Application State: The Apple Reminders application must be accessible and contain at least one defined list.