Integrations

Allows interaction with Apple Calendars on macOS, providing tools for listing calendars, retrieving events, and creating, updating, or deleting calendar events.
Enables access to macOS calendar functionality, allowing AI models to manage calendar events through a standardized interface on macOS systems.

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

Clone this repository
Install dependencies:
npm install
Build the TypeScript code:
npm run build

Usage

Make sure the Calendar API Bridge is running on port 8080
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:

ISO8601 with milliseconds and Z timezone (recommended):
2025-03-09T10:00:00.000Z
ISO8601 without milliseconds:
2025-03-09T10:00:00
ISO8601 with space instead of T:
2025-03-09 10:00:00
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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

A Model Context Protocol server for AI models to access and manipulate Apple Calendar data on macOS through a standardized interface.