Google Calendar

You can securely connect Google Calendar data to an MCP client to ask natural-language questions and perform calendar actions through streaming MCP interactions. This server pair handles OAuth authentication with Google and exposes an MCP interface so clients can read, create, or modify calendar events via natural language.

How to use

To use the Google Calendar MCP Server, run the OAuth server first to authorize access to your Google Calendar, then start the MCP server to expose calendar actions to your MCP client. Connect your MCP client and point it at the MCP endpoint to begin streaming calendar commands and responses.

Typical usage flow:

1. Complete Google OAuth authorization so the server can access your calendar data. 2) Run the MCP server to start the streaming interface. 3) Configure your MCP client with the local MCP endpoint to begin sending natural-language requests like querying events or creating reminders.

How to install

Prerequisites you need before installing: Python and Poetry for dependency management.

Step 1: Set Up Google API Credentials

1. Go to the Google Cloud Console

2. Create or select a project

3. Enable the Google Calendar API

4. Go to Credentials → Create OAuth 2.0 Client ID

• Choose Desktop App

• Set branding and add test user emails in audience

5. Download the OAuth credentials as client_secret.json

6. Place this file in the root directory of the project

Step 2: Install Dependencies

poetry install

Step 3: Start the OAuth Server

poetry run uvicorn src.main:app --host 0.0.0.0 --port 8000

This will open a browser for OAuth authentication. If it does not, visit the URL shown in your console. After successful authentication, a session.json file will be created with access and refresh tokens.

Step 4: Run the MCP Server

poetry run python src/server.py

This launches a streamable MCP-compatible HTTP server at http://localhost:8080/mcp.

Step 5: Connect MCP Client (Claude Desktop)

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

Add this entry to the config to connect to the MCP server:

{
  "mcpServers": {
    "google-calendar-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8080/mcp"
      ]
    }
  }
}

Additional notes

Verify integration by opening Claude Desktop settings and confirming the MCP server appears under Settings -> integrations after adding the config.

Project structure and dependencies

Key components include a Google OAuth server and an MCP server that uses saved credentials to interact with Google Calendar API v3.

Core dependencies include FastAPI, Uvicorn, Google Auth libraries, and Poetry for dependency management.

Available tools

calendar_mcp

MCP endpoint that allows natural-language calendar operations by streaming to an MCP client.