Google Drive MCP サーバーの設定方法 (2026年版)
Model Context Protocol を介して Google Drive を AI アシスタントに接続する
Hyperealで構築を始めよう
Kling、Flux、Sora、Veoなどに単一のAPIでアクセス。無料クレジットで開始、数百万規模まで拡張可能。
クレジットカード不要 • 10万人以上の開発者 • エンタープライズ対応
2026年版 Google Drive MCP サーバーの設定方法
ドキュメント、仕様書、または参照資料が Google Drive 上にある場合、MCP(Model Context Protocol)を介して AI コーディングアシスタントに接続することで、コンテンツを何度もコピー&ペーストする代わりに、AI がそれらのドキュメントを直接読み取れるようになります。このガイドでは、Google Drive MCP サーバーのセットアップ、認証の設定、そして Claude Desktop、Claude Code、Cursor、その他の MCP 対応ツールへの接続方法について解説します。
Google Drive MCP でできること
接続されると、AI アシスタントは以下のことが可能になります:
- 検索: Google Drive 内のファイルを名前または内容で検索。
- 読み取り: Google Docs、Sheets、Slides、およびアップロードされたファイル(PDF、テキストファイル、画像)の読み取り。
- リスト化: 特定のフォルダ内のファイルを一覧表示。
- スプレッドシート データの読み取り: 分析のために Google Sheets からデータを取得。
- 共有ドライブへのアクセス: チームフォルダや共有ドライブへのアクセス。
実用的なユースケース
| ユースケース | 例 |
|---|---|
| 仕様書からのコーディング | 「共有ドライブにある API 仕様書を読み取って、TypeScript の型を生成して」 |
| データ分析 | 「Google スプレッドシートから第4四半期の指標を取得して、トレンドを要約して」 |
| ドキュメント作成 | 「Drive 内のスタイルガイドを確認して、このコンポーネントのドキュメントを書き直して」 |
| ミーティングノート | 「昨日のスタンドアップノートを読んで、Jira チケットを作成して」 |
| デザインレビュー | 「製品要件ドキュメントを読んで、私の実装と比較して」 |
事前準備
開始前に以下が必要になります:
- Google Cloud Platform アカウント(無料枠で動作します)
- Drive アクセス権のある Google Workspace または個人の Gmail アカウント
- インストール済みの Node.js 18+
- MCP 対応の AI クライアント(Claude Desktop、Claude Code、Cursor など)
ステップ 1: Google Cloud プロジェクトの作成
- Google Cloud コンソールにアクセスします。
- 上部の [プロジェクトを選択] をクリックし、[新しいプロジェクト] を選択します。
- プロジェクト名を
mcp-drive-serverなどに設定します。 - [作成] をクリックします。
ステップ 2: Google Drive API の有効化
- 新しいプロジェクトで、[API とサービス] > [ライブラリ] に移動します。
- 「Google Drive API」 を検索します。
- それをクリックし、[有効にする] を押します。
- スプレッドシートへのアクセスが必要な場合は、「Google Sheets API」 も検索して有効にします。
ステップ 3: OAuth 2.0 クライアント ID の作成
MCP サーバーがあなたの代わりに Drive にアクセスするには、OAuth 認証情報が必要です。
- [API とサービス] > [認証情報] に移動します。
- [認証情報を作成] > [OAuth クライアント ID] をクリックします。
- 同意画面の設定を求められた場合は、まず OAuth 同意画面 を設定します:
- [外部] を選択(Workspace ユーザーの場合は [内部] も可)。
- アプリ名を入力:
MCP Drive Server - テストユーザーとして自分のメールアドレスを追加。
- 同意画面でのスコープ設定は不要です(実行時にリクエストされます)。
- [認証情報] に戻り、アプリケーションの種類として [デスクトップ アプリ] を選択します。
- 名前を
MCP Drive Serverに設定します。 - [作成] をクリックします。
- JSON ファイルをダウンロードし、
gcp-oauth.keys.jsonとして保存します。
# ダウンロードしたファイルを安全な場所に移動
mkdir -p ~/.config/mcp
mv ~/Downloads/client_secret_*.json ~/.config/mcp/gcp-oauth.keys.json
ステップ 4: Google Drive MCP サーバーのインストール
公式の Google Drive MCP サーバーをインストールします:
npm install -g @anthropic/mcp-server-gdrive
または、npx を使用して実行します(インストール不要):
npx -y @anthropic/mcp-server-gdrive
ステップ 5: Google での認証
サーバーを初めて実行するときは、Google Drive へのアクセスを許可するための OAuth フローを完了させる必要があります。
# 認証フローを実行
npx -y @anthropic/mcp-server-gdrive auth --keys-file ~/.config/mcp/gcp-oauth.keys.json
これにより以下が行われます:
- ブラウザで Google ログインページが開きます。
- MCP サーバーに Drive へのアクセス権限を付与するよう求められます。
- 将来の使用のために、リフレッシュトークンがローカルに保存されます。
トークンは ~/.config/mcp/gdrive-credentials.json に保存されます。このファイルは厳重に保管してください。
# トークンが保存されたか確認
ls -la ~/.config/mcp/gdrive-credentials.json
ステップ 6: AI クライアントへの接続
Claude Desktop
Claude Desktop の設定ファイルを編集します:
# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Windows
code %APPDATA%\Claude\claude_desktop_config.json
Google Drive サーバーを追加します:
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-server-gdrive"],
"env": {
"GDRIVE_OAUTH_KEYS_FILE": "/Users/あなたの名前/.config/mcp/gcp-oauth.keys.json",
"GDRIVE_CREDENTIALS_FILE": "/Users/あなたの名前/.config/mcp/gdrive-credentials.json"
}
}
}
}
Claude Desktop を再起動します。ツールメニュー(ハンマーアイコン)に Google Drive ツールが表示されるはずです。
Claude Code (CLI)
Claude Code の設定に MCP サーバーを追加します:
claude mcp add gdrive \
--command "npx" \
--args "-y" "@anthropic/mcp-server-gdrive" \
--env "GDRIVE_OAUTH_KEYS_FILE=/Users/あなたの名前/.config/mcp/gcp-oauth.keys.json" \
--env "GDRIVE_CREDENTIALS_FILE=/Users/あなたの名前/.config/mcp/gdrive-credentials.json"
または、~/.claude/mcp.json にある設定ファイルを直接編集します:
{
"servers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-server-gdrive"],
"env": {
"GDRIVE_OAUTH_KEYS_FILE": "/Users/あなたの名前/.config/mcp/gcp-oauth.keys.json",
"GDRIVE_CREDENTIALS_FILE": "/Users/あなたの名前/.config/mcp/gdrive-credentials.json"
}
}
}
}
Cursor
Cursor の設定で MCP サーバーを追加します:
- [Settings] (
Cmd+,) を開きます。 - 「MCP」 を検索します。
- [Edit in settings.json] をクリックするか、MCP 設定セクションに移動します。
- Google Drive サーバーを追加します:
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-server-gdrive"],
"env": {
"GDRIVE_OAUTH_KEYS_FILE": "/Users/あなたの名前/.config/mcp/gcp-oauth.keys.json",
"GDRIVE_CREDENTIALS_FILE": "/Users/あなたの名前/.config/mcp/gdrive-credentials.json"
}
}
}
}
ステップ 7: Google Drive MCP を使う
サーバーが接続されると、自然言語で Google Drive と対話できるようになります。
ファイルの検索
あなた: Google Drive で 「API 仕様書」 を検索して。
AI: [gdrive ツール: search_files を使用]
一致するファイルが 3 つ見つかりました:
1. "API Specification v3.2" (Google ドキュメント、共有ドライブ)
2. "API Specification - Draft" (Google ドキュメント、マイドライブ)
3. "api-spec-old.pdf" (PDF、マイドライブ)
これらのいずれかを読み取りますか?
ドキュメントの読み取り
あなた: "API Specification v3.2" を読んで、ユーザーエンドポイントの TypeScript インターフェースを生成して。
AI: [gdrive ツール: read_file を使用]
ドキュメントを読み取りました。仕様に基づいた TypeScript インターフェースは以下の通りです:
interface User {
id: string;
email: string;
name: string;
role: 'admin' | 'user' | 'viewer';
createdAt: string;
...
}
スプレッドシート データの読み取り
あなた: "Q4 Metrics" スプレッドシートを読んで、主要なトレンドを要約して。
AI: [gdrive ツール: read_spreadsheet を使用]
Q4 指標の要約です:
- 月間アクティブユーザー数(MAU)が 23% 増加 (45K から 55K)
- 収益が 15% 増加 ($120K から $138K)
- 解約率(チャーンレート)が 4.2% から 3.8% に低下
...
フォルダ内容のリスト化
あなた: "Engineering/Design Docs" フォルダにはどんなファイルがある?
AI: [gdrive ツール: list_files を使用]
Engineering/Design Docs フォルダには以下のファイルがあります:
- Architecture Overview.gdoc (1月15日更新)
- Database Schema.gdoc (1月22日更新)
- API Design Principles.gdoc (12月3日更新)
- Deployment Runbook.gdoc (1月28日更新)
利用可能な MCP ツール
Google Drive MCP サーバーは以下のツールを提供します:
| ツール | 説明 | パラメータ |
|---|---|---|
search_files |
名前または内容でファイルを検索 | query (string) |
read_file |
ファイルの内容を読み取る | fileId (string) |
list_files |
フォルダ内のファイルを一覧表示 | folderId (string, optional) |
read_spreadsheet |
Google Sheets からデータを読み取る | spreadsheetId, range |
トラブルシューティング
「Token has been expired or revoked」(トークンの期限切れまたは失効)
再認証を行ってください:
npx -y @anthropic/mcp-server-gdrive auth --keys-file ~/.config/mcp/gcp-oauth.keys.json
「Access Not Configured」(アクセス未設定)エラー
GCP プロジェクトで Google Drive API が有効になっているか確認してください:
- console.cloud.google.com/apis/library にアクセスします。
- 「Google Drive API」を検索します。
- [有効] と表示されていることを確認します。
サーバーは起動するがツールが表示されない
MCP サーバーのログを確認してください。Claude Desktop の場合は以下を確認します:
# macOS
~/Library/Logs/Claude/mcp-gdrive.log
# または Claude Desktop の開発者コンソールを確認
# [View] > [Developer] > [Developer Tools]
ブラウザでの「App is not verified」(アプリが未確認)警告
OAuth フロー中、アプリがテストモードであるため Google が警告を表示することがあります。[詳細] > [MCP Drive Server (安全ではない) に移動] をクリックして続行してください。これは個人利用の OAuth アプリでは通常の挙動です。
ファイルが見つからない
MCP サーバーは、認証された Google アカウントが表示権限を持つファイルにのみアクセスできます。ファイルが見つからない場合は:
- ファイルがあなたの Google アカウントと共有されているか確認してください。
- アクセス権のある共有ドライブにファイルがあるか確認してください。
- 正確なファイル名で検索を試みてください。
セキュリティに関する考慮事項
トークンの保管
OAuth トークンはマシンのローカルに保存されます。これらを保護してください:
# 制限された権限を設定
chmod 600 ~/.config/mcp/gdrive-credentials.json
chmod 600 ~/.config/mcp/gcp-oauth.keys.json
スコープの制限
MCP サーバーはデフォルトで Drive への読み取り専用アクセスを要求します。サーバーの実装が明示的にサポートしていない限り、ファイルの変更、削除、作成はできません。
共有ドライブ
共有ドライブ(チームドライブ)へのアクセスが必要な場合は、OAuth 同意画面に drive.readonly スコープが含まれていること、および Google Workspace 管理者が共有ドライブへの API アクセスを制限していないことを確認してください。
ドキュメントアクセスを超えて
Google Drive を AI アシスタントに接続することは、より大きなワークフローの一部に過ぎません。Drive から仕様書を読み取ると同時に、視覚的コンテンツ、ビデオ、またはオーディオを生成する必要がある AI 駆動型アプリケーションを構築している場合、Hypereal AI は、MCP で強化された開発環境と相性の良い、メディア生成のための統合 API を提供しています。
まとめ
Google Drive MCP サーバーのセットアップには、GCP プロジェクトの作成、Drive API の有効化、OAuth 認証情報の生成、および AI クライアントの設定が含まれます。一度接続すれば、AI アシスタントは Drive 内のあらゆるファイルを検索、読み取り、分析できるようになります。最大の難所は OAuth の設定ですが、一度認証されればトークンは維持され、接続はシームレスになります。ドキュメントとコードの間の溝を埋めるために、ぜひ活用してください。
