mcp-google-gdrive

Googleドライブ、ドキュメント、スプレッドシート、スライド用のMCPサーバーです。AIアシスタントが複数のGoogleアカウントにわたり、ファイル、フォルダ、権限、ラベル、ゴミ箱を完全に読み書きできるようにします。Workspace形式の自動変換（ドキュメントからMarkdownへ、スプレッドシートからCSV/JSONへ、スライドからテキストへ）が含まれています。

ツール

アカウント管理

ファイル

フォルダ

ゴミ箱

権限

ラベル

Googleドキュメント

Googleスプレッドシート

Googleスライド

v2.2の新機能

• outputFormat パラメータ — 12個の読み取り/一覧表示ツールが outputFormat: "json" | "yaml" | "text" を受け入れるようになりました。デフォルトは json（下位互換性あり）です。構造化された出力には yaml を、人間が読みやすいコンパクトなテーブルには text を使用してください。対応ツール: list_accounts, list_files, list_folder, list_trash, list_permissions, list_labels, list_file_labels, list_sheets, get_metadata, read_sheet_range, get_slide_thumbnail, search_files。

v2.1

• gdrive_download_file — ドライブからローカルディスクパスへ任意のファイルをダウンロード。Workspaceファイル（ドキュメント、スプレッドシート、スライド）は指定された形式（pdf, docx, xlsx, pptx, csv, txt, html, または markdown）に自動的にエクスポートされます。

• エクスポートツールの savePath — gdrive_export_doc, gdrive_export_sheet, gdrive_export_slides がオプションの savePath パラメータを受け入れるようになりました。指定された場合、バイナリ形式（docx, pdf, xlsx, pptx）はbase64として返されるのではなく、ディスクに保存されます。savePath を省略するとv2.0の動作が維持されます。

• gdrive_list_accounts のメールアドレス解決 — メールアドレスの代わりに「migrated」と表示されていたv0.xから移行されたアカウントは、初回呼び出し時にGoogle userinfo APIを介して自動的に解決されるようになりました。

• ドキュメントの修正 — gdrive_empty_trash に結果整合性についての注記を追加。gdrive_transfer_ownership に組織間制限についての注記を追加。

出力形式

すべての読み取りおよび一覧表示ツールは outputFormat パラメータをサポートしています:

例: gdrive_list_files({ query: "name contains 'report'", outputFormat: "text" }) は以下を返します:

files:
  id             name              mimeType         modifiedTime  size
  -------------  ----------------  ---------------  ------------  ----
  abc123def456   Q1 Report.pdf     application/pdf  2026-04-01    1024
  ghi789jkl012   Q2 Report.docx    application/pdf  2026-03-15    2048
resultCount: 2

前提条件

• Node.js 18以上

• 以下のAPIが有効なGoogle Cloudプロジェクト:

  • Google Drive API

  • Google Docs API

  • Google Sheets API

  • Google Slides API

• OAuth2デスクトップアプリケーションの認証情報

セットアップ

1. Google Cloud Console でプロジェクトを作成し、Drive、Docs、Sheets、Slides APIを有効にします

2. OAuth2認証情報（アプリケーションタイプ: デスクトップアプリ）を作成し、JSONファイルをダウンロードします

3. 認証情報ファイルを保存します:

mkdir -p ~/.config/mcp-google-gdrive
cp ~/Downloads/client_secret_*.json ~/.config/mcp-google-gdrive/credentials.json
chmod 600 ~/.config/mcp-google-gdrive/credentials.json

4. 一回限りの認証フローを実行します:

npx mcp-google-gdrive --auth primary

これにより、Googleの同意用URLが表示されます。アクセスを許可した後、認証コードをターミナルに貼り付けてください。

マルチアカウント設定

一意のラベルを使用して追加のアカウントを追加します:

npx mcp-google-gdrive --auth work
npx mcp-google-gdrive --auth personal

各アカウントは ~/.config/mcp-google-gdrive/tokens/{label}.json に独自のトークンファイルを保持します。ツールで account パラメータを使用してどのアカウントを使用するかを指定するか、gdrive_switch_account を呼び出してデフォルトを変更してください。

設定

Gemini CLI

~/.gemini/settings.json に追加:

{
  "mcpServers": {
    "google-gdrive": {
      "command": "npx",
      "args": ["-y", "mcp-google-gdrive"]
    }
  }
}

watsonx Orchestrate

orchestrate toolkits import --kind mcp \
  --name google-gdrive \
  --description "Google Drive, Docs, Sheets, Slides" \
  --command "npx -y mcp-google-gdrive" \
  --tools "*"

Claude Code

claude mcp add -s user google-gdrive -- npx -y mcp-google-gdrive

VS Code / Cursor

ワークスペースの .vscode/mcp.json に追加:

{
  "mcpServers": {
    "google-gdrive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-gdrive"]
    }
  }
}

認証

サーバーはGoogleドライブへのアクセスにOAuth2を使用します。認証情報はローカルに保存されます:

• ~/.config/mcp-google-gdrive/credentials.json — OAuth2クライアント（アカウント間で共有）

• ~/.config/mcp-google-gdrive/tokens/{label}.json — アカウントごとのトークン（chmod 600）

• ~/.config/mcp-google-gdrive/config.json — アクティブなアカウントとアカウントレジストリ

アクセストークンは1時間で期限切れになり、保存されたリフレッシュトークンを使用して自動的に更新されます。トークンの更新は透過的であり、ユーザーの操作は不要です。

v0.xからの移行

シングルアカウントのv0.xインストールからアップグレードする場合、サーバーは初回起動時に既存の token.json を tokens/primary.json に自動的に移行します。

関連するMCPサーバー

• mcp-redhat-account - Red Hatアカウント管理

• mcp-redhat-knowledge - Red Hatナレッジベース検索

• mcp-redhat-manpage - RHEL manページ

• mcp-redhat-subscription - サブスクリプション管理

• mcp-redhat-support - サポートケース管理

ライセンス

MIT