Workspace MCP — Google Workspace Tools via MCP

简介

Workspace MCP 通过 MCP 暴露 Gmail/Drive/Calendar 等工具；提供 uv 启动分层与 HTTP 模式，并给出适配 Claude Code OAuth 流程的配置示例。

• 适合谁： 需要通过 OAuth 自动化 Google Workspace，并希望工具集可精细控制的 agent
• 可搭配： Python + uv/uvx、Google OAuth 凭证、MCP 客户端（OAuth 推荐 HTTP）
• 准备时间： 25–60 分钟

实战建议

• 数据点：文档默认的 HTTP 端点是 http://localhost:8000/mcp。
• 量化建议：先用 --tool-tier core，再逐步开启 extended/complete，减少授权范围。

常用打法：把鉴权与工具放量分开

Google OAuth 最稳的落地顺序： 1）先让一个用户授权跑通， 2）先跑只读工具， 3）再逐步开放写入权限。

加固建议

• OAuth 场景与多人场景优先用 HTTP transport。
• OAuth client secret 放到密钥管理（不要提交 .env）。
• 每个 workflow 只暴露最小工具集。

FAQ

能用 stdio 模式吗？ 答：README 更推荐 OAuth 场景使用 HTTP 模式以保证完整支持。

怎么限制权限？ 答：先用更小的 tool tier，只有需要时再开放写工具。

支持 VS Code MCP 吗？ 答：支持。README 给了 .vscode/mcp.json 示例并提示要用 HTTP transport。