apple-calendar-mcp

# 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](https://github.com/your-username/swift-apple-api) 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