mcp-google-calendar

A minimal MCP server for Google Calendar using OAuth 2.0 and the Google Calendar API.

Tools

• connect_calendar() and calendar_health()

• list_calendars()

• list_events(...) and get_event(...)

• create_event(...), with recurrence, attendees, and optional Google Meet

• update_event(...) and delete_event(...)

• list_calendar_acl(...) and share_calendar(...)

• watch_calendar_events(...)

• list_event_changes(...)

create_event, update_event, delete_event, share_calendar, and watch_calendar_events have external side effects. MCP clients should request explicit confirmation before calling them.

Related MCP server: gcal-mcp

Setup

1. Enable the Google Calendar API in Google Cloud Console.

2. Create an OAuth client with application type Desktop app.

3. Download the OAuth file as credentials.json into this directory.

4. Install dependencies and start the server:

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python server.py

The first connection opens a browser for authorization and creates token.json. Both credentials.json and token.json are ignored by Git.

Optional .env configuration:

GOOGLE_CREDENTIALS=credentials.json
GOOGLE_TOKEN=token.json
GOOGLE_CALENDAR_TIMEZONE=Asia/Jakarta

MCP Client

{
  "mcpServers": {
    "google-calendar": {
      "command": "python",
      "args": [
        "C:/Users/your-user/Documents/GitHub/mcp-google-calendar/server.py"
      ]
    }
  }
}