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