実践ガイド

CodexでGoogle Drive・Docsを操作する方法
MCP連携の実践ガイド

スプレッドシート連携の次は、ファイル検索とドキュメント編集。CodexからDrive・Docsを扱う具体的な手順を解説します。

CodexでGoogleスプレッドシートを操作する方法はすでに紹介しましたが、業務で使うGoogle Workspaceはスプレッドシートだけではありません。Driveに散らばった資料を横断検索させたり、Googleドキュメントの下書きを作らせたりという需要も多いはずです。本記事では、CodexからGoogle Drive・Docsを操作する具体的な手順を解説します。

前提

本記事は2026年7月時点の情報をもとにしています。Google Drive・Docs向けのMCPサーバーは複数の実装が公開されており、認証方式やツールの対応範囲は提供元によって異なります。導入前に利用するMCPサーバーの最新ドキュメントを必ず確認してください。

Drive・Docs連携の全体像

スプレッドシート連携と同様、CodexからGoogle Workspaceを直接操作できるわけではなく、間に立つ接続手段が必要です。Drive・Docsの場合、実務では大きく2つのルートがあります。

ルート	向いている用途	特徴
MCPサーバー経由	Driveのファイル検索・Docsの読み書きをAIに任せたい	自然言語の指示だけで「資料を探して要約して」が完結する
Google API直接呼び出し	特定のファイルを確実に決まった手順で処理したい	Codexにコードを書かせ、Drive API・Docs APIを直接叩く

「とりあえずAIエージェントとして使わせたい」ならMCP、「決まった処理をバッチ的に確実に回したい」ならAPI直接呼び出し、という使い分けが基本方針です。

MCPサーバーを使ったDrive・Docs連携

Google Workspace向けのMCPサーバーは、Composioなどのサービス経由で使うものから、GitHub上で公開されている個人・コミュニティ実装まで複数存在します。名称やパッケージ構成は実装ごとに異なるため、導入するサーバーの公式リポジトリ・公式ドキュメントに記載された具体的なインストール手順に従うのが確実です。多くはGoogle Drive・Docs・Sheets・Gmail・Calendarなどをまとめて扱える設計になっています。

Codexへの登録方法（設定の骨格）

どの実装を選んでも、Codex側での登録方法はconfig.tomlにmcp_serversのエントリを追加する、という骨格は共通です。

~/.codex/config.toml（骨格の例）

[mcp_servers.google-workspace]
command = "選んだMCPサーバーの起動コマンド"
args = ["選んだMCPサーバーの引数"]
env = { GOOGLE_CLIENT_ID = "your-client-id", GOOGLE_CLIENT_SECRET = "your-client-secret" }

コマンド・パッケージ名は導入するサーバーの公式手順を確認する

Google Workspace向けMCPサーバーは似た名前のパッケージが複数公開されており、非公式・メンテナンスされていない実装も混在しています。command・argsに入れる具体的な値は、必ず導入するMCPサーバーの公式GitHubリポジトリやドキュメントに記載されたものをコピーしてください。

多くのGoogle Workspace向けMCPサーバーは、Google Cloud Consoleで発行したOAuthクライアント情報を使って認証します。初回起動時にブラウザでの認証フローが挟まる実装が一般的です。

MCPでできることの例

Drive内のファイルをキーワードやフォルダ指定で検索する
指定したGoogleドキュメントの内容を読み取り、要約する
複数のドキュメントを横断して該当箇所を探す
会議メモやレポートの下書きをDocsとして新規作成する
既存ドキュメントの特定セクションを追記・修正する

プロンプト例

Driveの「提案資料」フォルダから今期の提案書を探して、
要点を3つにまとめたうえで、新しいGoogleドキュメントとして
「提案書サマリー」を作成して

Google API直接呼び出しでの連携

本番の自動化処理や、確実に同じ手順で処理したいバッチ的な作業には、Codexにコードを書かせてDrive API・Docs APIを直接呼び出す方が向いています。

Python例：Docs APIでの読み取り

from googleapiclient.discovery import build
from google.oauth2.credentials import Credentials

creds = Credentials.from_authorized_user_file("token.json")
docs_service = build("docs", "v1", credentials=creds)

document = docs_service.documents().get(documentId=DOCUMENT_ID).execute()
content = document.get("body").get("content")

Codexに「このドキュメントIDの内容を取得して要約するPythonスクリプトを書いて」と依頼すれば、認証まわりの雛形も含めて実装させられます。

権限設計の考え方

最初は読み取り専用から

Drive・Docsへの書き込み権限を広く与えると、意図しないファイルの上書き・削除につながるリスクがあります。導入初期は読み取り専用スコープから始め、対象フォルダを限定し、書き込みが必要になった段階で慎重に権限を広げるのが安全です。

対象フォルダ・対象ドキュメントを限定する（Drive全体への無制限アクセスを避ける）
破壊的な操作（削除、共有設定の変更）は別のツール・別の確認フローに分ける
OAuthのスコープは必要最小限にする（drive.readonlyから始める等）

スプレッドシート連携との使い分け

すでにCodexでスプレッドシートを操作している場合、Drive・Docs連携は自然な拡張になります。

対象	典型的な使い方
Sheets	構造化された数値データの集計・分析・レポート化
Drive	散らばった資料の横断検索、関連ファイルの発見
Docs	議事録・報告書・提案書などの文章ベースのドキュメント作成

「Driveから関連資料を探す→Docsの下書きを作る→数値部分はSheetsで集計する」という一連の流れを、1つのMCPサーバー構成でまとめて任せることもできます。