← 返回目录

Google Drive MCP

社区

通过 MCP 安全访问 Google Drive、Docs、Sheets、Slides 和日历

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 云存储第 4 / 15
Stars: ★ 224 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 1 天前
工具数: 1

61FMRS · C

一个功能较全面的第三方 Google Drive/Workspace MCP 服务器,提供 116 个工具并支持本地和托管两种部署模式,但需要用户自行完成 Google Cloud OAuth 配置,且非 Google 官方维护。

最强项 · 文档质量 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

13/20

维护活跃度

13/20

文档质量

15/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: README 展示了启动命令（npx -y @piotr-agier/google-drive-mcp）和一个 authGetStatus 调用示例，manifest 中声明了单一 stdio 传输的 npm 包，工具数量声称为 116 个，但仓库材料中未提供任何 CI 工作流文件或已提交的测试用例来验证这些工具的行为与声明是否一致。README 提到 docs/development.md 中有 'build commands, tests'，但该文档内容未随附，无法核实测试覆盖范围或错误处理机制。根据静态评审规则，没有可验证的执行证据（真实 CI + 覆盖关键路径的测试）不得给出 12 分以上，因此本项评分保持在静态上限之下，反映'声明与真实行为一致性未经证实'和'错误处理/依赖控制信息缺失'的双重扣分。
安全与权限 13/20: manifest 明确将 GOOGLE_DRIVE_OAUTH_CREDENTIALS 标记为必需且敏感（isSecret），README 的 Security 一节提到不要提交凭据/令牌、使用最小 OAuth 范围、默认将 HTTP 绑定在 127.0.0.1、team-store.json 含刷新令牌需当作机密处理，这些是积极信号，未发现红线级问题（无恶意代码、无硬编码密钥、无未经确认的不可逆默认行为的直接证据）。但示例用例中出现'将一年前的文件移动到 Archive 文件夹'这类具有副作用的操作，README 全文没有说明对破坏性操作（删除、移动、覆盖分享权限等）是否存在客户端确认或工具级别的二次确认机制；team 模式和外部令牌管理增加了攻击面，但该文档同样未提供在此仓库中给出。因此虽无红线问题，权限最小化与危险操作确认的证据不完整，属于中等偏上但非满分的情况。
维护活跃度 13/20: 项目采用 MIT 许可证，manifest 标注版本为 2.6.0，README 引用了 CHANGELOG.md 表明存在版本发布记录，仓库未被归档（Archived: False），并提供了 GitHub Issues 作为缺陷报告渠道。但提供的材料中没有任何提交历史、发布日期或议题响应时间的直接证据；'Open issues: 0' 既可能说明维护良好，也可能说明项目关注度低或议题被清理，无法据此判断维护活跃度，只能视为中性信息而非加分项。缺少可核实的持续维护证据（如最近提交时间、依赖更新记录）导致本项不能给出高分。
文档质量 15/20: README 被显式重构为一个分层文档索引，指向 setup、clients、authentication、configuration、deployment、tools、troubleshooting、development 等八个专题指南，并在正文中提供了四个具体使用场景示例（整理 Drive、生成报表、编辑文档、准备会议），这种结构本身是文档质量较高的信号。但由于本次评审只能看到 README 和 manifest，链接的具体指南内容未包含在证据范围内，因此工具参数、限制、成本、故障排除的具体质量无法逐项核实，只能基于目录结构和链接完整性给予有保留的较高分，而非满分。
安装易用性 12/20: README 提供了从创建 Google Cloud OAuth 凭据、下载 JSON 文件到指定路径、运行 npx ... auth 完成授权、再到编辑 mcpServers 配置并重启客户端的完整四步流程，并给出了具体的 JSON 配置示例，属于有据可查的安装路径。但该流程本质上依赖用户在 Google Cloud Console 中手动启用多个 API、配置 OAuth 同意屏幕、创建桌面应用凭据等多个手动步骤，过程繁琐且容易出错（README 自身也提供了故障排除指南佐证这一点）。根据静态评审规则，没有可验证的执行证据时安装易用性不得超过 15 分；结合手动步骤较多、跨多个外部控制台操作的复杂性，评分低于该上限。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络修改第三方账户数据

适合谁

需要通过 Claude Desktop 或其他本地 MCP 客户端管理 Google Drive 文件的个人用户
希望自托管、掌控自身 Google 凭据和令牌的团队或开发者
需要跨 Docs、Sheets、Slides、Calendar 完成多步骤 Workspace 自动化的场景

不适合谁

需要官方 Google 出品或维护的 MCP 集成的用户(本项目为第三方开发)
希望零配置、无需自行创建 Google Cloud OAuth 凭据即可使用的用户
需要覆盖 Google Workspace 全部 API(而不仅是 Drive、Docs、Sheets、Slides、Calendar)的场景

所需权限

Google OAuth 2.0 凭据(GOOGLE_DRIVE_OAUTH_CREDENTIALS,必填且为敏感文件路径)
对 Google Drive、Docs、Sheets、Slides、Calendar 的 API 访问范围(由用户在 Google Cloud 项目中启用并授权)
本地存储的 OAuth 令牌文件(tokens.json),团队模式下还包括 team-store.json 中的成员刷新令牌

风险与副作用

tokens.json 和 team-store.json 一旦泄露即可能被用于访问用户的 Google 账号,需妥善保密
以 HTTP 方式部署时,若未将监听地址限制在 127.0.0.1 或未启用 TLS 与访问控制,可能被未授权访问
授予的 OAuth 权限范围过宽可能带来超出实际工具使用需求的数据访问风险

安装接入

准备工作

运行环境：Node.js

GOOGLE_DRIVE_OAUTH_CREDENTIALS 必填密钥指向 Google OAuth 2.0 Desktop 应用凭据 JSON 文件的路径；在 Google Cloud 项目中创建 OAuth 客户端（Desktop app 类型）后下载获得。

在 Google Cloud 项目中启用 Drive、Docs、Sheets、Slides 和 Calendar API,配置 OAuth 同意屏幕,并创建“Desktop app”类型的 OAuth 客户端;将下载的凭据 JSON 保存为 ~/.config/google-drive-mcp/gcp-oauth.keys.json(或通过 GOOGLE_DRIVE_OAUTH_CREDENTIALS 指定路径)。
运行 npx -y @piotr-agier/google-drive-mcp auth 完成浏览器中的 Google 授权流程,令牌默认存储在 ~/.config/google-drive-mcp/tokens.json。
在 MCP 客户端配置中添加该服务器(command: npx, args: ["-y", "@piotr-agier/google-drive-mcp"]),重启客户端。
调用 authGetStatus 确认当前生效的 Google 账号,再尝试只读的 Drive 搜索请求验证连接是否正常。

claude_desktop_config.json

{"mcpServers":{"google-drive":{"command":"npx","args":["-y","@piotr-agier/google-drive-mcp"]}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "google-drive": {
      "command": "npx",
      "args": [
        "-y",
        "@piotr-agier/google-drive-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add google-drive -- npx -y @piotr-agier/google-drive-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端中询问："运行 authGetStatus 并告诉我当前激活的 Google 账号"，如果返回账号信息，说明 OAuth 认证和连接均正常。

常见排障

运行 authGetStatus 检查当前生效的 Google 账号是否正确
若 Drive 搜索无结果,参考项目 docs/troubleshooting.md 中的故障排查指南
确认 GOOGLE_DRIVE_OAUTH_CREDENTIALS 指向的凭据文件路径正确且未被提交到版本库
检查 Google Cloud 项目中是否已启用 Drive、Docs、Sheets、Slides、Calendar 相关 API

试试这样问

连接成功后，可以直接对 AI 助手这样说：

运行 authGetStatus 并告诉我当前激活的是哪个 Google 账号。
搜索我的 Google Drive 中最近七天内修改过的文件。
在 /Reports 中找到 PDF 文件，创建一个 Archive 文件夹，并把超过一年的文件移进去。
创建一个月度结果的 Google Sheet，用 Google Doc 总结，并根据总结生成一个简短的 Google Slides 演示文稿。

工具能力 1

authGetStatus 只读

查询当前已认证的 Google 账号及认证状态

使用场景

整理 Drive 中的文件:查找特定类型文件、创建归档文件夹并按修改时间移动旧文件

自动生成报告:创建 Google Sheet 汇总数据,用 Google Doc 总结,再基于总结生成 Google Slides 演示文稿

编辑文档:查找指定文档,替换内容、设置格式并添加评论

安排会议:创建带 Google Meet 链接的日历事件,并从 Drive 附加相关文件

支持客户端

Claude Desktop

Gemini CLI

claude.ai custom connectors部分支持

依据项目文档列出，未经本站实测。

详细介绍

Google Drive MCP 是一个自托管的第三方 MCP 服务器,让 Claude Desktop 等 MCP 客户端能够管理 Google Drive 文件,并操作 Google Docs、Sheets、Slides 和 Calendar。项目提供 116 个工具,涵盖文件管理、共享云端硬盘、权限、版本历史、富文本文档编辑、表格格式化、幻灯片制作和日历事件。支持本地 stdio 传输配合 OAuth 认证(适合 Claude Desktop 等本地客户端),也支持 Streamable HTTP 传输配合团队模式(适合托管部署和多用户场景)。凭据和令牌保存在用户自己的运行环境中,而非交由第三方托管。