gcal-fast-mcp

Google Calendar MCP server built with FastMCP. Provides 10 tools for calendar management, event CRUD, and availability queries via the Google Calendar API v3.

Setup

1. Google OAuth Credentials

Place your Google Cloud OAuth client credentials at ~/.gcal-mcp/gcp-oauth.keys.json (or in the project directory — they'll be copied automatically).

If you already have a GCP project configured for another Google API (e.g. gmail-fast-mcp), you can reuse the same OAuth client — just enable the Google Calendar API in that project.

2. Authenticate

uv run python -m gcal_fast_mcp auth

This opens a browser for the OAuth flow and saves tokens to ~/.gcal-mcp/credentials.json.

For cloud environments with a custom callback URL:

uv run python -m gcal_fast_mcp auth https://your-domain.com/oauth2callback

3. Run the Server

uv run python -m gcal_fast_mcp

MCP Client Configuration

{
  "mcpServers": {
    "google-calendar": {
      "command": "uv",
      "args": ["--directory", "/path/to/gcal-fast-mcp", "run", "google-calendar-fast-mcp"]
    }
  }
}

Related MCP server: GoogleCalendarMCP

Tools

Configuration

Environment variables (prefix GCAL_):

Google Calendar API Scopes

• calendar — Full calendar access

• calendar.events — Event CRUD operations