MCP Apple Calendars

A Model Context Protocol (MCP) server for interacting with Apple Calendars on macOS. This module allows AI models to access and manipulate calendar data through a standardized interface.

Prerequisites

• macOS 12.0 or later
• Node.js 16.0 or later
• Calendar API Bridge running locally

Installation

1. Clone this repository
2. Install dependencies: npm install
3. Build the TypeScript code: npm run build

Usage

1. Make sure the Calendar API Bridge is running on port 8080
2. Start the MCP server: npm start

Available Tools

The MCP server provides the following tools for AI models:

• getCalendars: List all available calendars
• getCalendarEvents: Get events from a specific calendar
• createCalendarEvent: Create a new event in a calendar
• updateCalendarEvent: Update an existing event
• deleteCalendarEvent: Delete an event from a calendar

Date Formats

When creating or updating events, you can use any of the following date formats:

1. ISO8601 with milliseconds and Z timezone (recommended): 2025-03-09T10:00:00.000Z

2. ISO8601 without milliseconds: 2025-03-09T10:00:00

3. ISO8601 with space instead of T: 2025-03-09 10:00:00

4. ISO8601 with forward slashes: 2025/03/09 10:00:00

The Calendar API Bridge has been updated to handle these date formats automatically.

Development

To run the server in development mode with automatic reloading:

npm run dev

License

MIT