适合谁
- 需要通过 Claude Desktop 或其他本地 MCP 客户端管理 Google Drive 文件的个人用户
- 希望自托管、掌控自身 Google 凭据和令牌的团队或开发者
- 需要跨 Docs、Sheets、Slides、Calendar 完成多步骤 Workspace 自动化的场景
G
61FMRS · C
一个功能较全面的第三方 Google Drive/Workspace MCP 服务器,提供 116 个工具并支持本地和托管两种部署模式,但需要用户自行完成 Google Cloud OAuth 配置,且非 Google 官方维护。
Google Drive MCP 是一个自托管的第三方 MCP 服务器,让 Claude Desktop 等 MCP 客户端能够管理 Google Drive 文件,并操作 Google Docs、Sheets、Slides 和 Calendar。项目提供 116 个工具,涵盖文件管理、共享云端硬盘、权限、版本历史、富文本文档编辑、表格格式化、幻灯片制作和日历事件。支持本地 stdio 传输配合 OAuth 认证(适合 Claude Desktop 等本地客户端),也支持 Streamable HTTP 传输配合团队模式(适合托管部署和多用户场景)。凭据和令牌保存在用户自己的运行环境中,而非交由第三方托管。
工具能力
authGetStatus
查询当前已认证的 Google 账号及认证状态
安装接入
- 在 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"]}}}
选型与风险
不适合谁
- 需要官方 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 权限范围过宽可能带来超出实际工具使用需求的数据访问风险
常见排障
- 运行 authGetStatus 检查当前生效的 Google 账号是否正确
- 若 Drive 搜索无结果,参考项目 docs/troubleshooting.md 中的故障排查指南
- 确认 GOOGLE_DRIVE_OAUTH_CREDENTIALS 指向的凭据文件路径正确且未被提交到版本库
- 检查 Google Cloud 项目中是否已启用 Drive、Docs、Sheets、Slides、Calendar 相关 API
使用场景
整理 Drive 中的文件:查找特定类型文件、创建归档文件夹并按修改时间移动旧文件
自动生成报告:创建 Google Sheet 汇总数据,用 Google Doc 总结,再基于总结生成 Google Slides 演示文稿
编辑文档:查找指定文档,替换内容、设置格式并添加评论
安排会议:创建带 Google Meet 链接的日历事件,并从 Drive 附加相关文件
支持客户端
Claude Desktop完整支持
Gemini CLI完整支持
claude.ai custom connectors部分支持