An MCP server that enables natural language interaction with macOS Calendar for creating events, modifying them, managing schedules, and finding available time.

Installation

From Source

# Clone the repository
git clone https://github.com/Omar-V2/mcp-ical.git
cd mcp-ical

# Install dependencies
uv sync

Configuration

Claude Desktop

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

Features

• Create events using natural language with calendar selection
• Support for location and notes for events
• Smart reminders and recurring events
• Intelligent schedule management and availability checking
• Smart event updates and modifications
• Support for multiple calendars, including Google Calendar integration when synced with iCloud
• View all available calendars with smart suggestions

Usage Examples

What's my schedule for next week?

Add a lunch meeting with Sarah tomorrow at noon

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

When am I free to schedule a 2-hour meeting next Tuesday?

Notes

Requires macOS with the Calendar app configured and the uv package manager installed. Claude must be run from the terminal for proper calendar permission requests. On first use of calendar commands, macOS will request calendar access. Tests create temporary calendars and should only be run in a development environment.