Google Calendar MCP OAuth Proxy

この Worker は、MCP クライアント（Codex など）と Google 公式 Calendar MCP の間の OAuth 境界として機能します。

Codex / MCP client
        |
        | OAuth to this Worker
        v
Cloudflare OAuth Provider
        |
        | Google OAuth (client ID + client secret)
        v
Google OAuth
        |
        | Google access token
        v
Google Calendar MCP
https://calendarmcp.googleapis.com/mcp/v1

クライアントが Google OAuth クライアントシークレットを受け取ることはありません。Google のアクセストークンとリフレッシュトークンは、Cloudflare OAuth プロバイダーが管理する暗号化された OAuth grant props に保存されます。保護された /mcp ハンドラーは、MCP トラフィックを上流に転送する前に、クライアントのローカル Bearer トークンをユーザーの Google アクセストークンに置き換えます。

Google のスコープ

wrangler.jsonc は、GOOGLE_OAUTH_SCOPES で Google Calendar のスコープを定義しています。

https://www.googleapis.com/auth/calendar.calendarlist.readonly
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.events.readonly
https://www.googleapis.com/auth/calendar.calendars

Worker は、コールバックが Google の user-info エンドポイントを使用して許可されたユーザーを特定するため、email profile を自動的に追加します。

Google の認可リクエストは、Google がリフレッシュトークンを返すように、access_type=offline と prompt=consent も使用します。

Related MCP server: google-mcp-server

ローカルシークレット

サンプルファイルをコピーします。

cp .dev.vars.example .dev.vars

設定します。

GOOGLE_CLIENT_ID=<Google OAuth web client ID>
GOOGLE_CLIENT_SECRET=<Google OAuth client secret>
COOKIE_ENCRYPTION_KEY=<strong random secret>
HOSTED_DOMAIN=<optional Google Workspace domain restriction>

GOOGLE_OAUTH_SCOPES と GOOGLE_MCP_URL は、wrangler.jsonc 内の非シークレット Worker 変数です。

Google Cloud OAuth クライアント

Google OAuth の Web アプリケーション クライアントを使用してください。

認可されたリダイレクト URI は、この Worker またはトンネルの公開ホスト名に /callback を加えたものにする必要があります。

https://mcp-auth.example.com/callback

上記の Calendar スコープを Google Auth Platform の同意 / データアクセス設定に追加してください。

ローカルで実行する

依存関係をインストールし、Worker の型を生成します。

npm install
npm run cf-typegen

Wrangler をポート 5555 でローカル起動します。

npm run dev

ローカルエンドポイントは次のとおりです。

http://localhost:5555/mcp

OAuth では 公開HTTPS コールバックが必要なため、エンドツーエンドのローカルテストには Cloudflare Tunnel を使用します。

固定の名前付きトンネル

同じコールバックを Google Cloud に登録する必要があるため、固定ホスト名が望ましいです。

npx wrangler dev --tunnel-name=mcp-google-auth --tunnel

名前付きトンネルのホスト名を Wrangler 開発サーバーにルーティングするように設定します。例:

https://mcp-auth.example.com  ->  local Wrangler dev server

次に登録します。

https://mcp-auth.example.com/callback

を Google OAuth のリダイレクト URI として登録します。

Codex に公開される MCP URL は次のとおりです。

https://mcp-auth.example.com/mcp

Codex の設定

この Worker は Codex から見た OAuth 認可サーバーであるため、Codex は Google クライアント ID や Google クライアントシークレットを必要としません。

[mcp_servers.google_calendar_proxy]
enabled = true
url = "https://mcp-auth.example.com/mcp"
auth = "oauth"

次に認証します。

codex mcp login google_calendar_proxy

期待されるフローは次のとおりです。

1. Codex がこの Worker の OAuth エンドポイントを検出します。

2. Codex がこの Worker に登録 / 認証します。

3. Worker がブラウザーを Google に送ります。

4. Google が Worker / トンネルの /callback に戻ります。

5. Worker が GOOGLE_CLIENT_SECRET を使用して Google の認可コードを交換します。

6. Codex は Worker が発行した OAuth トークンを受け取ります。

7. /mcp への呼び出しは、ユーザーの Google アクセストークンを使用して、Google 公式 Calendar MCP に転送されます。

トークンリフレッシュの動作

Google のリフレッシュトークンは、暗号化された OAuth grant props に保持されます。プロキシは、Google アクセストークンの isolate ローカルな有限 LRU キャッシュを保持し、エントリがリフレッシュウィンドウに達すると削除し、キャッシュを 100 ユーザーに制限します。保存されたアクセストークンが期限切れの場合、または Google の MCP が 401 を返した場合、Worker は Google のリフレッシュトークンと Worker 側のクライアントシークレットを使用して新しい Google アクセストークンを発行し、1 回だけ再試行します。

インメモリキャッシュは単なる最適化です。新しい Worker の isolate は、暗号化された grant props から常にリフレッシュできます。

レガシーグラント

リフレッシュトークン対応の前に作成された OAuth grant には、元の Google アクセストークンとユーザーメタデータのみが含まれます。プロキシはこれらの grant を検出し、Google がそのアクセストークンをまだ受け入れている間は、既存のアクセストークンを使い続けます。Google がそのトークンを拒否すると、Worker は 401 invalid_token を返すため、不十分な資格情報でリフレッシュを試みるのではなく、MCP 接続を再認証できます。