Google Drive

google-drive-mcp

Google Drive 用の MCP サーバーです。ファイルやフォルダーの一覧表示、検索、アップロード、ダウンロード、管理ができます。

ユースケース

ファイルに基づく回答：「Q2 の取締役会資料に記載された売上目標は何でしたか？」→ Drive を検索して該当するドキュメントを読み、質問に回答します。

プロジェクトのひな形作成：新しいベンダーのオンボーディングを開始する際に、契約書、コンプライアンス、成果物、議事録用のサブフォルダーを含むフォルダー構成を作成し、テンプレートのドキュメントとスプレッドシートも用意します。

フィードバックの統合：「直近 10 件のプレゼン資料に対するマネージャーからのフィードバックを要約してください」→ 複数のファイルからコメントを読み取り、傾向と改善点を特定します。

ローカライズのワークフロー：「日本で業務委託者の受け入れを始めます。オンボーディングフォルダーを英語から日本語に翻訳し、現地に合わせた調整が必要な箇所（人事ポリシー、休日など）に印を付けてください」→ 複数のドキュメントを読み取り、翻訳して、確認が必要な箇所を強調します。

（これらはあくまで例です。ファイルの検索、読み取り、整理が必要なワークフローであれば、どれでも利用できます。Google ドキュメントの読み取りや編集には google-docs-mcp を、Google スプレッドシートには google-sheets-mcp を組み合わせて使用してください。）

セットアップ

1. Google OAuth 認証情報を作成する

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成します（または既存のものを使用します）
3. Google Drive API を有効にします
4. APIs & Services → OAuth consent screen に移動し、同意画面を設定します
5. APIs & Services → Credentials → Create Credentials → OAuth client ID に移動します
6. Web application を選択します
7. http://localhost:3000/callback を Authorized redirect URIs に追加します
8. Client ID と Client Secret を控えます

2. サーバーを起動する

GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start

サーバーはデフォルトで http://localhost:3000 で実行されます。PORT=3001 で変更できます。

3. MCP クライアントに追加する

サーバーを起動した状態で、install-mcp の手順に従ってください。MCP クライアント（Claude Code、Claude Desktop、Cursor、Cline、VS Code など）に適した設定が生成されます。

アーキテクチャ

このサーバーは Google への OAuth プロキシとして動作します。

graph LR
    A[MCP client] <--> B[google-drive-mcp] <--> C[Google OAuth/API]

1. /.well-known/oauth-authorization-server を介して、自身を OAuth 認可サーバーとして通知します
2. /register が Google OAuth クライアントの認証情報を返します
3. /authorize が Google にリダイレクトし、クライアントのコールバック URL を state にエンコードします
4. /callback が Google からコードを受け取り、クライアントのコールバックに転送します
5. /token がクライアント認証情報を挿入して、トークンリクエストを Google に中継します
6. /mcp が MCP リクエストを処理し、ベアラートークンを使って Drive API を呼び出します

このサーバーはトークンも状態も保持せず、Google への OAuth を中継するだけです。

ツール

ツール	説明
ファイル
files_list	Drive のクエリ構文を使ってファイルを一覧表示／検索します
file_get	ファイルのメタデータを取得します
file_download	ファイルの内容をダウンロードします（Google Docs／Sheets のエクスポートに対応）
file_upload	新しいファイルをアップロードします
file_update	ファイルの内容またはメタデータを更新します
file_copy	ファイルをコピーします
file_move	ファイルを別のフォルダーに移動します
file_trash	ゴミ箱に移動します
file_untrash	ゴミ箱から復元します
file_delete	完全に削除します
フォルダー
folder_create	新しいフォルダーを作成します
コメント
comments_list	ファイルのコメントを一覧表示します
comment_get	コメントとその返信を取得します
comment_create	ファイルにコメントを追加します
comment_reply	コメントに返信します
comment_resolve	コメントを解決済みまたは未解決にします
返信
replies_list	コメントへの返信を一覧表示します
reply_get	特定の返信を取得します
reply_update	返信を更新します
reply_delete	返信を削除します
権限
permissions_list	ファイルにアクセスできるユーザーを一覧表示します
permission_get	特定の権限を取得します
permission_create	ユーザー、グループ、ドメイン、または全員とファイルを共有します
permission_update	ユーザーのアクセスレベルを変更します
permission_delete	ファイルへのアクセス権を取り消します

Drive クエリ構文

files_list ツールでは、フィルタリングに Drive のクエリ構文を使用できます。

# By name
name contains 'report'
name = 'Budget 2024'

# By type
mimeType = 'application/pdf'
mimeType = 'application/vnd.google-apps.folder'
mimeType = 'application/vnd.google-apps.document'

# By folder
'folder-id' in parents

# By ownership
'[email protected]' in owners

# Combined
name contains 'report' and mimeType = 'application/pdf'

Google Drive API のスコープ

• drive - Drive ファイルへのフルアクセス

コントリビューション

GitHub でのプルリクエストを歓迎します。始めるには、次の手順に従ってください。

1. Git と Node.js をインストールします
2. リポジトリをクローンします
3. npm install で依存関係をインストールします
4. npm run test を実行してテストを実行します
5. npm run build でビルドします

リリース

バージョンはセマンティックバージョニング仕様に従います。

リリースするには、次の手順に従ってください。

1. npm version <major | minor | patch> を使ってバージョンを更新します
2. git push --follow-tags を実行してタグとともにプッシュします
3. GitHub Actions が NPM レジストリに公開するまで待ちます。