Google Drive MCP Server (Official)

Google Drive MCP Server (Official) とは？

Google Drive MCP Server (Official) は、Google がホストする Google Drive MCP サーバーで、エンドポイントは https://drivemcp.googleapis.com/mcp/v1 です。AI エージェントがユーザー自身の権限で Drive のファイルを検索・読み取り・作成・コピー・ダウンロードできます。現在は Developer Preview です。

リモートサーバーなので、ローカルで何かを動かす必要はありません。通信は Streamable HTTP、認証は OAuth 2.0 です。現時点では Google Workspace Developer Preview Program への参加が必要です。設定方法とツール一覧は Google のガイド Configure the Drive MCP server にあります。以前のオープンソースのリファレンスサーバーも mcp.so に Google Drive MCP Server として掲載されていますが、アーカイブ済みです。

Google Drive MCP Server (Official) の使い方

前提条件は、Developer Preview への参加と Google Cloud プロジェクトです。下のコマンドを実行する場合は gcloud CLI も必要です。API キーは不要で、自分で作成する OAuth クライアントで認証します。

1. プロジェクトで Drive API と Drive MCP サービスを有効にします。

gcloud services enable drive.googleapis.com --project=PROJECT_ID
gcloud services enable drivemcp.googleapis.com --project=PROJECT_ID

2. Google Auth Platform > Branding で OAuth 同意画面を設定します。選べるなら Internal を選び、選べなければ External にして自分をテストユーザーに追加します。Data Access で次のスコープを追加します。

https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.file

3. Google Auth Platform > Clients > Create Client で OAuth クライアントを作成します。種類は Web application を選び、使うクライアントのリダイレクト URI（下記）を追加して、Use this client for an AI-powered agent を選択します。作成後、クライアント ID とシークレットをコピーします。

Claude Desktop

Claude.ai と Claude Desktop のカスタムコネクタを使うには、Pro、Max、Team、Enterprise のいずれかのプランが必要です。OAuth のリダイレクト URI には https://claude.ai/api/mcp/auth_callback を使います。Settings（または Admin settings）> Connectors > Add custom connector を開き、次を入力します。

• Server name：Google Drive
• Remote MCP server URL：https://drivemcp.googleapis.com/mcp/v1
• Advanced settings：OAuth クライアント ID とクライアントシークレット

Antigravity

リダイレクト URI には https://antigravity.google/oauth-callback を使います。次の内容を ~/.gemini/config/mcp_config.json に追加し、MCP 設定（Antigravity CLI では /mcp）を開いて Authenticate を選びます。

{
  "mcpServers": {
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "${OAUTH_CLIENT_ID}",
        "clientSecret": "${OAUTH_CLIENT_SECRET}"
      }
    }
  }
}

その他のクライアント（Claude Code、Cursor、VS Code）

Google はこれらのクライアント向けの個別手順を公開していません。OAuth 対応のリモートサーバーに接続できるクライアントなら、Google の汎用設定が使えます。サーバー名は drive、URL は https://drivemcp.googleapis.com/mcp/v1、トランスポートは Streamable HTTP、認証は OAuth 2.0 です。クライアントは事前に作成したクライアント ID とシークレットを使える必要があり、そのクライアント自身のコールバック URL をリダイレクト URI として登録してください。

接続テストには「Summarize the file Marketing Plan.」と聞いてみてください。クライアントが search_files を呼び、続いて read_file_content を呼べば成功です。

Google Drive MCP Server (Official) の主な機能

• Google が運用しているため、インストール・ホスティング・更新が不要
• OAuth 2.0 で認証するリモートの Streamable HTTP エンドポイント
• サインインしたユーザーと同じ権限・データガバナンス設定を引き継ぐ
• Drive 全体の全文検索・構造化検索と、最近のファイルの一覧
• Docs や Sheets などのファイルを自然言語のテキストとして読み取り、コメントも取得可能
• ファイルやフォルダ（Google Docs、Sheets、Slides を含む）の作成、コンテンツのアップロード、ファイルのコピー
• OAuth スコープは drive.readonly と drive.file のみに限定
• ファイルの削除、ゴミ箱への移動、共有を行うツールはない

Google Drive MCP Server (Official) のツール

サーバーは単一の /mcp/v1 ツールセットで 8 つのツールを提供しています。

• ファイルを探す：search_files はタイトル、全文、MIME タイプなどで構造化クエリを実行します。list_recent_files は最近のアクティビティ、最終更新日時、自分による最終更新日時のいずれかで並べ替えます。
• ファイルを読む：read_file_content はファイルをテキストとして返し、コメントも含められます。download_file_content は元データを base64 で返し、Google ファイルにはエクスポート用の MIME タイプを指定できます。get_file_metadata と get_file_permissions は詳細情報とアクセスできるユーザーを表示します。
• ファイルを書く：create_file はファイルやフォルダを作成またはアップロードします。copy_file はファイルを複製し、新しいタイトルや親フォルダも指定できます。

Google Drive MCP Server (Official) のユースケース

• ドキュメントの要約：「Marketing Plan ファイルを要約して、未解決の論点を挙げて」。
• 情報の検索：「今週自分が編集した Q3 予算に関するスプレッドシートを探して」。
• Drive への下書き：「Projects フォルダに Meeting Notes という Google Doc を作って、この箇条書きを入れて」。
• テンプレートの活用：「Proposal Template をコピーして、Acme Proposal という名前にして」。
• アクセス権の確認：「Roadmap ファイルには誰がアクセスできる？」
• エージェントのパイプライン：エージェントが Drive のコンテンツを他のツールに渡せます。すべての操作はユーザーが確認します。

Google Drive MCP Server (Official) と代替ツールの比較

アーカイブ済みのリファレンス版 Google Drive MCP Server はローカルで動作する読み取り専用のサーバー（ツールは search の 1 つだけ）で、npm パッケージは非推奨になっています。Google Workspace MCP などのコミュニティサーバーは、Drive に加えて Gmail、Calendar、Docs、Sheets にも対応し、Developer Preview への参加も不要です。ただしセルフホストが必要で、保守しているのは第三者です。プレビューに参加できるなら、公式の Google Drive MCP サーバーがサポート付きのホスト型の選択肢になります。

Google Drive MCP Server (Official) のトラブルシューティング

• リクエストが拒否される：OAuth クライアントで Use this client for an AI-powered agent を選択する必要があります。既存のクライアントで変更できない場合は、エージェント専用のクライアントを新しく作成してください。
• 1 時間ほどで再ログインを求められる：クライアントがリフレッシュトークンを受け取れていません。クライアントがカスタムの認可パラメータに対応していれば、認可リクエストに access_type=offline を追加します（新しいトークンを取得するには prompt=consent も追加）。
• 接続エラー：管理者にセキュリティ調査ツールで OAuth のログイベントを確認してもらいます。
• サービスが見つからない、またはアクセスが拒否される：drivemcp.googleapis.com と drive.googleapis.com が有効になっているか、アカウントが Developer Preview Program に参加しているかを確認します。