calendar-mcp

MCP server that lets AI agents manage Google Calendar -- create events, check availability, and manage schedules.

Tools

Tool	Description
calendar_list_events	List upcoming events from a calendar
calendar_create_event	Create a new event with attendees, reminders, location
calendar_update_event	Update an existing event
calendar_delete_event	Delete an event
calendar_free_busy	Check availability across multiple calendars
calendar_find_slot	Find the next available meeting slot

Google Calendar API Setup

1. Create a Google Cloud project

1. Go to Google Cloud Console
2. Create a new project (or select an existing one)
3. Enable the Google Calendar API:
   • Navigate to APIs & Services > Library
   • Search for "Google Calendar API" and click Enable

2. Create a Service Account

1. Go to APIs & Services > Credentials
2. Click Create Credentials > Service account
3. Give it a name and click Done
4. Click into the service account, go to the Keys tab
5. Click Add Key > Create new key > JSON
6. Save the downloaded JSON key file somewhere safe

3. Share your calendar with the service account

1. Copy the service account email address (looks like name@project.iam.gserviceaccount.com)
2. Open Google Calendar
3. Go to Settings > Settings for my calendar > [Your Calendar]
4. Under Share with specific people or groups, add the service account email
5. Set the permission to Make changes to events (or See all event details for read-only)

4. Configure the environment

Set the path to your service account key file:

export GOOGLE_SERVICE_ACCOUNT_KEY=/path/to/your/service-account-key.json

Or create a .env file in the project root:

GOOGLE_SERVICE_ACCOUNT_KEY=/path/to/your/service-account-key.json

Installation

pip install -e .

Usage

As an MCP server

Add to your MCP client configuration:

{
  "mcpServers": {
    "calendar": {
      "command": "calendar-mcp",
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY": "/path/to/key.json"
      }
    }
  }
}

Run directly

calendar-mcp

Examples

List events for the next week:

"Show me my upcoming events for this week"

Create a meeting:

"Schedule a 1-hour meeting called 'Sprint Planning' tomorrow at 2pm with alice@example.com"

Find an open slot:

"Find a 30-minute slot for a meeting with Bob sometime this week during working hours"

Check availability:

"Is my calendar free next Tuesday afternoon?"