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 电子邮件解析 — 从 v0.x 迁移且显示“migrated”而非电子邮件地址的账户，现在会在首次调用时通过 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"]
    }
  }
}

身份验证

该服务器使用 OAuth2 进行 Google 云端硬盘访问。凭据存储在本地：

• ~/.config/mcp-google-gdrive/credentials.json — OAuth2 客户端（跨账户共享）

• ~/.config/mcp-google-gdrive/tokens/{label}.json — 每个账户的令牌（chmod 600）

• ~/.config/mcp-google-gdrive/config.json — 活动账户和账户注册表

访问令牌在一小时后过期，并使用存储的刷新令牌自动刷新。令牌刷新是透明的，无需用户交互。

从 v0.x 迁移

如果从单账户 v0.x 安装升级，服务器会在首次启动时自动将现有的 token.json 迁移到 tokens/primary.json。

相关 MCP 服务器

• mcp-redhat-account - Red Hat 账户管理

• mcp-redhat-knowledge - Red Hat 知识库搜索

• mcp-redhat-manpage - RHEL 手册页

• mcp-redhat-subscription - 订阅管理

• mcp-redhat-support - 支持案例管理

许可证

MIT