mcp-ical

Overview

The mcp-ical server enables users to interact with their macOS Calendar through natural language commands. It provides a conversational interface for creating, updating, and querying calendar events. The server supports features like event creation with custom calendars, recurring events, location and notes, smart reminders, and schedule availability checking. It integrates seamlessly with iCloud and Google Calendar when configured properly.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• create_event

  Create a new calendar event from natural language

  Try:Schedule a team lunch next Thursday at 1 PM at Bistro GardenTry:Set up my weekly team sync every Monday at 9 AMTry:Add a dentist appointment to my Personal calendar for next Wednesday at 3 PM
• query_schedule

  Query calendar events using natural language

  Try:What's my schedule for next week?Try:When am I free to schedule a 2-hour meeting next Tuesday?
• update_event

  Modify an existing calendar event

  Try:Move tomorrow's team meeting to 3 PM insteadTry:Change the location of Friday's meeting to Conference Room B
• list_calendars

  List all available calendars

  Try:Show me my available calendarsTry:What calendars do I have?

Note: Tool names inferred from functionality descriptions in the README. The actual tool names are not explicitly defined in a dedicated tools section, but the functionality is clearly described in the Features section.

Comparable tools

Installation

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

# Install dependencies
uv sync

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

/Applications/Claude.app/Contents/MacOS/Claude

FAQ

Does this work with Google Calendar?

Yes, if you have Google Calendar synced with your iCloud Calendar, you can create events in your Google Calendar by specifying the Google calendar when creating/updating events.

What macOS versions are supported?

The README doesn't specify exact macOS version requirements, but it requires macOS with the Calendar app configured.

Compare mcp-ical with