MCP ExplorerExplorer

Apple Calendar Mcp

@shadowfax92on a year ago
1 MIT
FreeCommunity
AI Systems
MCP server for managing Apple Calendars on macOS via a standardized interface.

Overview

What is Apple Calendar Mcp

apple-calendar-mcp is a Model Context Protocol (MCP) server designed for interacting with Apple Calendars on macOS. It allows AI models to access and manipulate calendar data through a standardized interface.

Use cases

Use cases for apple-calendar-mcp include integrating AI models into applications that manage personal or team calendars, automating event creation and updates, and developing tools that require calendar data manipulation.

How to use

To use apple-calendar-mcp, ensure that the Calendar API Bridge is running on port 8080. Clone the repository, install the dependencies using ‘npm install’, build the TypeScript code with ‘npm run build’, and then start the MCP server with ‘npm start’.

Key features

Key features of apple-calendar-mcp include tools for listing available calendars, retrieving events from a specific calendar, creating new calendar events, updating existing events, and deleting events.

Where to use

apple-calendar-mcp can be used in various fields that require calendar management, such as personal productivity applications, scheduling software, and AI-driven task management systems.

Content

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

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

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers