この記事で作るもの・前提知識

Google WorkspaceをAIツールから操作する方法には、大きく2つの系統があります。

今回扱うのは後者です。Claude CodeとCodexのどちらでも同じ設定を使い回せるのが最大のメリットで、一度この認証情報を作ってしまえば、どちらのツールからでも同じMCPサーバー経由でGoogle Workspaceを操作できます。

ステップ1：Google Cloudプロジェクトを作成する

ステップ2：必要なAPIを有効化する

操作したいGoogle Workspaceサービスに応じて、対応するAPIを有効化します。gcloud CLIが使える場合は、次のコマンドでまとめて有効化できます。

gcloud services enable \
  gmail.googleapis.com \
  drive.googleapis.com \
  docs.googleapis.com \
  sheets.googleapis.com \
  slides.googleapis.com \
  calendar-json.googleapis.com \
  chat.googleapis.com \
  people.googleapis.com \
  --project=あなたのプロジェクトID

gcloudを使わない場合は、Google Cloud Consoleの「APIとサービス」→「ライブラリ」から、それぞれのAPI名を検索して個別に「有効にする」をクリックしても構いません。

ステップ3：OAuth同意画面（Google Auth Platform）を設定する

「APIとサービス」→「OAuth同意画面」（英語UIではGoogle Auth Platform）を開き、ウィザードに沿って設定します。

Branding（ブランディング）

• アプリ名：任意の名前（例：Workspace MCP for Claude）
• ユーザーサポートメール：自分のメールアドレス

Audience（対象ユーザー）

Google Workspaceの組織アカウントであれば「Internal」（組織内限定・審査不要）を選べます。個人のGoogleアカウント（Gmail.comなど）の場合は「External」一択になります。

Contact Information・Finish

通知用のメールアドレスを入力し、Google API Services User Data Policyに同意して完了します。

Data Access（データアクセス・スコープの追加）

「Data Access」タブの「Add or Remove Scopes」から、使いたい機能に応じたスコープを追加します。代表的なものは次の通りです。

ステップ4（Chatを使う場合のみ）：Chatアプリを設定する

Google Chatを操作したい場合は、API有効化だけでは不十分です。Chatアプリとしての設定が別途必要になります。

この設定を済ませておかないと、Chat APIを有効化していても実際の読み書きリクエストが失敗します。

ステップ5：OAuthクライアントIDを作成する（Desktop app）

ステップ6：ブラウザ認証を実行してtoken.jsonを取得する

ここからはローカル環境での作業です。Google公式のクライアントライブラリを使い、実際にブラウザ経由でユーザー認証を行います。

pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib

次のようなスクリプトを用意します（Google公式クイックスタートの標準的な構成です）。

import os.path
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow

SCOPES = [
    "https://www.googleapis.com/auth/gmail.readonly",
    "https://www.googleapis.com/auth/gmail.compose",
]

def get_credentials():
    creds = None
    if os.path.exists("token.json"):
        creds = Credentials.from_authorized_user_file("token.json", SCOPES)
    if not creds or not creds.valid:
        if creds and creds.expired and creds.refresh_token:
            creds.refresh(Request())
        else:
            flow = InstalledAppFlow.from_client_secrets_file("credentials.json", SCOPES)
            creds = flow.run_local_server(port=0)
        with open("token.json", "w") as token:
            token.write(creds.to_json())
    return creds

if __name__ == "__main__":
    get_credentials()
    print("認証完了。token.jsonを保存しました。")

ステップ7：Claude Code・Codexに接続する

取得したcredentials.json・token.jsonは、MCPサーバー経由でClaude Code・Codexから利用します。ここでは、Desktop app方式のOAuthに対応したコミュニティ製MCPサーバー（google_workspace_mcp）を例に接続方法を示します。

Claude Codeに接続する

claude mcp add --transport http workspace-mcp http://localhost:8000/mcp

MCPサーバー自体をローカルで起動しておく必要があります（uvx workspace-mcp --transport streamable-httpのような形）。詳細な起動オプションは利用するMCPサーバーのドキュメントに従ってください。

Codexに接続する

Codexは~/.codex/config.tomlに[mcp_servers.名前]のブロックを追記する形で設定します。

# ~/.codex/config.toml
[mcp_servers.workspace]
command = "uvx"
args = ["workspace-mcp", "--transport", "stdio"]

[mcp_servers.workspace.env]
GOOGLE_OAUTH_CREDENTIALS = "/path/to/credentials.json"

Claude CodeとCodexのどちらも、同じcredentials.json・token.jsonを参照する設定にしておけば、片方で認証を済ませれば、もう片方でも再認証は不要です。

もう1つの選択肢：Google公式のリモートMCPサーバー（claude.aiアプリ向け）

ここまではCLI（Claude Code・Codex）向けの構成でしたが、claude.aiのブラウザ版・デスクトップアプリで使うだけなら、Google自身がホストする公式のリモートMCPサーバーという選択肢もあります。この場合の設定は大きく異なります。

gcloud services enable \
  gmailmcp.googleapis.com \
  drivemcp.googleapis.com \
  calendarmcp.googleapis.com \
  chatmcp.googleapis.com \
  people.googleapis.com \
  --project=あなたのプロジェクトID

• OAuthクライアントは「Web application」タイプで作成し、リダイレクトURIにhttps://claude.ai/api/mcp/auth_callbackを指定する
• claude.aiの「設定」→「コネクタ」→「カスタムコネクタを追加」で、サービスごとのURL（例：Gmailならhttps://gmailmcp.googleapis.com/mcp/v1）とクライアントID・シークレットを登録する
• 認証はclaude.ai側のブラウザフローで完結し、ローカルにtoken.jsonのようなファイルは生成されない

「サーバーは自分で立てたくない、claude.aiだけで完結させたい」という場合はこちらが手軽です。なお、Googleは現時点でCodex向けの公式接続手順を公開していません。Codex自体はStreamable HTTPとOAuthに対応していますが、Google Workspaceのリモート MCPが要求するクライアント登録との互換性は、2026年7月時点で公式には確認されていません。Codexから使う場合は、この記事で解説したDesktop app方式（ローカルMCPサーバー）が確実です。

よくある質問

まとめ

まずはGmailなど1つのサービスだけでスコープを絞り、実際にtoken.jsonが生成されるところまで確認してみてください。他のサービスへ拡張する際は、対象APIの有効化・Data Accessでのスコープ追加・コード側のSCOPES変更・既存トークンへの再同意（またはtoken.jsonの再生成）・MCPサーバー側でのツール有効化が必要になります。仕組みそのものはここまでと同じなので、1つ理解すれば残りは横展開しやすいはずです。