Apple Calendars
About
Provides a TypeScript-based server for reading, creating, updating, and deleting macOS calendar events through a local HTTP bridge, enabling seamless scheduling and calendar management for desktop applications.
Details
- Repository
- shadowfax92/apple-calendar-mcp
Explore
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Apple CalendarsCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
@highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- macOS 12.0 or later
- Node.js 16.0 or later
- Calendar API Bridge running locally
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.
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
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"apple calendars": {
"env": {},
"args": [
"-y",
"@highlight/mcp-server"
],
"command": "npx"
}
}
}Linux
{
"env": [],
"args": [
"-y",
"@highlight/mcp-server"
],
"command": "npx"
}Macos
{
"env": [],
"args": [
"-y",
"@highlight/mcp-server"
],
"command": "npx"
}Windows
{
"env": [],
"args": [
"/c",
"npx",
"-y",
"@highlight/mcp-server"
],
"command": "cmd"
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
