calendar-mcp

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

Tools

Related MCP server: GoogleCalendarMCP

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?"