mcp-calendar

ai-mcp-garage/mcp-calendar

3.2

If you are the rightful owner of mcp-calendar and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP Calendar Server is a robust and efficient server designed for managing macOS Calendar with support for both multi-calendar and single-calendar modes.

MCP Calendar Server

A no-bullshit MCP server for macOS Calendar management. Supports both multi-calendar and scoped single-calendar modes.

Features

  • Multi-calendar mode: Full access to all your calendars
  • Scoped mode: Lock down to a single calendar (set CALENDAR_NAME env var)
  • CRUD operations: Create, read, update, delete events
  • Natural language: Works with Claude's conversational interface
  • Smart queries: Built-in shortcuts for common operations

Installation

git clone https://github.com/ai-mcp-garage/mcp-calendar.git
cd mcp-calendar
uv sync

Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "mcp-calendar": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp-calendar",
                "run",
                "mcp-ical"
            ],
            "env": {
                "CALENDAR_NAME": "Work",
                "CALENDAR_DESCRIPTION": "Work calendar for meetings and deadlines"
            }
        }
    }
}

Environment Variables

  • CALENDAR_NAME: Lock to specific calendar (optional)
  • CALENDAR_DESCRIPTION: Context for scoped calendar (optional)

Usage

Launch Claude from terminal to get calendar permissions:

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

Then use natural language:

  • "What's my schedule today?"
  • "Add meeting tomorrow 2pm"
  • "Delete all events next Friday"

Development

uv sync --dev
uv run pytest tests

License

MIT