The mcp-server-apple-reminders is an MCP server designed to provide seamless integration between AI models and the native Apple Reminders application on macOS. This server empowers AI models to intelligently create, list, and manage reminders directly within the user's Apple Reminders.

Key features include the ability to list all reminders and reminder lists, create new reminders with titles, details, and due dates, and mark reminders as complete or incomplete. It leverages native macOS integration to ensure reliability and performance.

By using this server, developers can enable AI models to understand and act on user requests related to task management, enhancing productivity and organization. The server interacts with Apple Reminders through a standardized MCP interface, allowing for easy integration with various AI clients like Cursor, ChatWise, and Claude Desktop. This provides a valuable tool for developers looking to add task management capabilities to their AI applications.

Native Reminder Interaction

The mcp-server-apple-reminders allows AI models to directly interact with the user's Apple Reminders application on macOS. This includes creating, listing, and managing reminders through natural language commands. The server acts as a bridge, translating AI requests into actions within the native Reminders app. This ensures a seamless user experience, as reminders are created and managed within the familiar Apple ecosystem. For example, a user could ask an AI assistant to "Create a reminder to buy milk at 6 PM tomorrow," and the server would automatically add this reminder to the user's default Reminders list with the specified due date. This functionality leverages a Swift binary to interface with the Apple Reminders database, ensuring native compatibility and performance.

Context-Aware Reminder Management

This server provides context-aware reminder management by allowing AI models to specify lists, due dates, and notes when creating reminders. This goes beyond simple reminder creation, enabling AI to organize and prioritize tasks effectively. Users can instruct the AI to add reminders to specific lists (e.g., "Shopping," "Work"), set precise due dates and times, and include detailed notes for additional context. For instance, a user could say, "Add a reminder to 'Submit report' to my 'Work' list, due next Friday, with the note 'Ensure all data is accurate.'" The server parses this request and creates a reminder with all the specified attributes. This feature enhances the utility of AI assistants by enabling them to manage reminders in a structured and organized manner, mirroring how users would manually manage their tasks.

Standardized MCP Interface

The mcp-server-apple-reminders exposes its functionality through a standardized Model Context Protocol (MCP) interface. This allows any AI model or client that supports the MCP to seamlessly integrate with Apple Reminders. The server defines specific MCP tools, such as create_reminder, list_reminders, and list_reminder_lists, each with well-defined input parameters and output formats. This standardization simplifies integration for developers, as they can interact with the server using a consistent protocol, regardless of the underlying implementation. For example, an AI assistant can use the create_reminder tool by providing the reminder title, due date, list, and note as parameters in a JSON payload. The server then processes this request and returns a standardized response indicating the success or failure of the operation.

Technical Implementation

The server is implemented using a combination of TypeScript and Swift. TypeScript handles the MCP server logic, including request parsing, response formatting, and communication with the AI client. Swift is used to interact directly with the Apple Reminders database, leveraging native macOS APIs for optimal performance and compatibility. The Swift code is compiled into a binary that is executed by the TypeScript server. This hybrid approach allows the server to leverage the strengths of both languages, providing a robust and efficient solution for integrating AI models with Apple Reminders. The project structure includes separate directories for TypeScript and Swift source code, as well as build scripts for compiling the Swift binary and TypeScript code.