MacOS Calendar Integration MCP Server

Calendar & ProductivityPython

Interact with your MacOS Calendar through natural language

Available Tools

create_event

Creates a new calendar event based on natural language description

event_descriptioncalendar_namestart_timeend_timelocationnotesreminderrecurrence

get_events

Retrieves calendar events for a specified time period

time_periodcalendar_name

update_event

Updates an existing calendar event

event_idupdated_fields

delete_event

Deletes a calendar event

event_id

get_calendars

Lists all available calendars

find_availability

Finds available time slots for scheduling

datedurationstart_timeend_time

The MacOS Calendar Integration MCP enables seamless interaction with your macOS calendar using natural language commands. It allows you to create, view, update, and manage calendar events through conversational queries, transforming calendar management into an intuitive experience. With this MCP, you can schedule meetings, check your availability, modify existing appointments, and manage multiple calendars all through simple text prompts. The integration supports advanced features like recurring events, custom reminders, and detailed event information, making it a powerful productivity tool for macOS users.

Overview

The MacOS Calendar Integration MCP transforms how you interact with your macOS calendar by enabling natural language commands. Instead of navigating through calendar interfaces, you can simply describe what you want to do, and the MCP will handle the rest.

Features

Event Creation

Create calendar events using natural language descriptions:

Schedule events with specific times and dates
Add locations and notes to events
Set up smart reminders
Create recurring events
Select specific calendars for event creation

Schedule Management

Easily access your calendar information:

View upcoming events for specific time periods
Check availability for scheduling meetings
Get comprehensive schedule overviews

Event Updates

Modify existing events naturally:

Reschedule events to different times or dates
Update event locations
Add or modify notes
Adjust reminders
Change recurring patterns
Move events between calendars

Calendar Management

View all available calendars
Get smart calendar suggestions
Works with Google Calendar when synced with iCloud

Installation

Prerequisites

macOS with Calendar app configured
uv package manager
An MCP-compatible client (Claude for desktop recommended)

Setup Steps

Clone the repository and install dependencies

git clone https://github.com/Omar-V2/mcp-ical.git
cd mcp-ical
uv sync

Configure your MCP client

For Claude for Desktop, create or edit the configuration file:

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the following configuration (replace the path with your actual path):

{
  "mcpServers": {
    "mcp-ical": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical",
        "run",
        "mcp-ical"
      ]
    }
  }
}

Launch Claude for Calendar Access

Important: Claude must be launched from the terminal to properly request calendar permissions:
```
/Applications/Claude.app/Contents/MacOS/Claude
```
Grant Calendar Permissions

When you first use a calendar-related command, macOS will prompt for calendar access. Accept this prompt to enable the MCP to interact with your calendar.

If the prompt doesn't appear, you may need to manually grant calendar access by following the instructions in the installation documentation.

Usage Examples

Creating Events

"Schedule a team lunch next Thursday at 1 PM at Bistro Garden"
"Set up my weekly team sync every Monday at 9 AM with a 15-minute reminder"
"Add a dentist appointment to my Personal calendar for next Wednesday at 3 PM"

Checking Schedule

"What's my schedule for next week?"
"When am I free to schedule a 2-hour meeting next Tuesday?"
"Show me all my events for this month"

Updating Events

"Move tomorrow's team meeting to 3 PM instead"
"Add notes to my 2 PM meeting about reviewing Q1 metrics"
"Change the location of my lunch meeting to Cafe Bistro"

Troubleshooting

Calendar Access Issues

If you're having trouble with calendar permissions:

Ensure you launched Claude from the terminal
Check System Preferences > Security & Privacy > Privacy > Calendar to verify Claude has access
Consult the detailed installation guide for manual access configuration

Recurring Events Limitations

Non-standard recurring schedules may not always be set correctly
Reminder timing for recurring all-day events may be off by one day

Additional Notes

This MCP works best with Claude 3.5 Sonnet for complex calendar operations
If you have Google Calendar synced with iCloud Calendar, you can create events in your Google Calendar by specifying the Google calendar name