mcp -apple-events

This MCP server provides native integration with Apple Reminders and Calendar on macOS through the Model Context Protocol. It exposes a standardized interface to manage reminders and calendar events, including listing resources, creating, updating, and deleting items, as well as advanced capabilities like priority handling, recurring reminders, location-based triggers, tags, subtasks, and bulk operations. The server leverages macOS system permissions and EventKit integration to interact with Reminders and Calendar, so you can perform operations from your preferred MCP-enabled tools or assistants.

To use it, configure your MCP clients (Cursor, Claude Desktop, or ChatWise) to point at the server entry. The recommended setup uses npx to run the server instance, for example via npx mcp-server-apple-events. Within your client configuration, add the server under mcpServers with the command and arguments as shown in the Quick Start example. Once connected, you can issue natural language prompts like creating reminders with due dates, setting priorities, defining recurring rules, or associating reminders with lists and tags. The server supports rich content such as titles, notes, URLs, and completion status, and it aims to provide robust error handling and diagnostics to help you troubleshoot permissions or integration issues.

Examples of supported interactions include listing reminders and lists with filters, creating reminders with specific due dates or URLs, marking as complete, updating fields like notes or due dates, and leveraging advanced search and batch operations across multiple reminders.

Prerequisites:

• Node.js 18 or later
• macOS (required for Apple Reminders integration)
• Xcode Command Line Tools (required for compiling Swift code)
• pnpm (recommended for package management)

Installation steps:

1. Ensure Node.js is installed. You can install or verify with:
   • node -v
   • npm -v
2. Install pnpm globally (recommended): npm install -g pnpm
3. Install the MCP server package (or run via npx as shown in Quick Start). If you prefer local installation: mkdir mcp-server-apple-events && cd mcp-server-apple-events pnpm init -y pnpm add mcp-server-apple-events
4. Run the server using the recommended npx approach (no local install needed): npx mcp-server-apple-events
5. Alternatively, if you build locally or want to run from a local path via node, follow the Option B in the Claude Desktop configuration to run the local build with Node and run.cjs, ensuring the path to run.cjs is absolute.

Notes:

• You may need to grant macOS permissions for Reminders and Calendars during first run. See the official README for details on permission prompts and troubleshooting.
• If you encounter permission or read errors, ensure Calendar access is set to Full Calendar Access in System Settings and re-run any permission checks as documented.

Environment and configuration tips:

• macOS permission handling is essential: Reminders and Calendars require appropriate read/write access. If a permission status is notDetermined, the system prompts will be shown; re-check permissions if issues arise.
• For Claude Desktop and other tools, you can configure the MCP server using either the npx approach or a local node path to run.cjs when you build locally.
• If you see calendar read errors, verify that the application has Full Calendar Access in System Settings > Privacy & Security > Calendars.
• Use the provided examples to validate that the server is connected and responding to commands via your MCP client.
• The server supports enhanced reminder features like priority, recurring rules, location-based triggers, tags, subtasks, and batch operations, which can help you manage large sets of reminders efficiently.