MCP Apple Calendars

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:

License

MIT