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
- Author
- shadowfax92
- Repository
- shadowfax92/apple-calendar-mcp
- GitHub stars
- 1
- Downloads
- 128
- Categories
- Design, Developer Tools, AI, Knowledge Base
- Tags
- #web, #integration
Jump to
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
1. Make sure the Calendar API Bridge is running on port 8080
2. Start the MCP server:
npm start
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"
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
