使用说明
谷歌工作区MCP服务器——安装指南
使用以下步骤将Claude Code连接到您的Google帐户的分步指南 谷歌工作区MCP服务器设置后，您可以让Claude阅读您的电子邮件、创建日历事件、编辑Google文档、查询表格等，所有这些都可以从终端完成。
所得
运行此MCP服务器后，Claude Code可以访问：
- Gmail --搜索、阅读和发送电子邮件
- 谷歌日历 --创建、修改和查询事件
- Google 云端硬盘 --搜索、读取、创建和共享文件
- 谷歌文件 --创建和编辑文档
- 谷歌表格 --读写电子表格数据
- 谷歌幻灯片 --创建和查看演示文稿
- 谷歌表单 --创建和查看表单
- 工作表 --创建和管理任务
- 谷歌联系人 --搜索和管理联系人
- 谷歌自定义搜索 -通过Google的API进行网络搜索
先决条件
- macOS （本指南是在Monterey 12.x上编写的；Linux应该稍作调整即可使用）
- 克劳德代码 安装和工作(安装指南)
- Google帐户 （免费Gmail运行良好）
第一步：安装uv
紫外线 是一个快速的Python包管理器。MCP服务器通过以下方式启动 uvx，随附。
curl -LsSf https://astral.sh/uv/install.sh | sh
重新启动终端（或运行 source ~/.zshrc)所以 uvx 命令可用。
第二步：创建谷歌云项目
- 首选 console.cloud.google.com/projectcreate
- 给它起个名字 克劳德MCP
- 点击 创建
这是免费的。不需要信用卡。
步骤3：启用Google API
选择新项目后，单击下面的每个链接并点击 启用:
| API | 启用链接 |
|---|---|
| Gmail | 启用 |
| 谷歌云端硬盘 | 启用 |
| 谷歌日历 | 启用 |
| 谷歌文档 | 启用 |
| 谷歌表格 | 启用 |
| 谷歌幻灯片 | 启用 |
| 谷歌表单 | 启用 |
| 谷歌任务 | 启用 |
| 谷歌联系人 | 启用 |
| 自定义搜索 | 启用 |
提示： 在单击“启用”之前，请确保在左上角的下拉列表中选择了正确的项目。
步骤4：配置OAuth同意屏幕
- 首选 API和服务→ OAuth同意屏幕
- 选择 外部的 作为用户类型，然后单击 创建
- 填写必填字段（应用程序名称、支持电子邮件）——其余字段可以留空
- 在 范围 页面，单击 保存并继续 （无需更改）
- 在 测试用户 页面，单击 添加用户 并输入您的Gmail地址
- 点击 保存并继续那么 返回仪表盘
重要提示：发布到生产环境
默认情况下，您的应用程序处于“测试”模式，这意味着您的OAuth令牌 每7天过期一次 而且你必须不断地重新进行身份验证。
要解决此问题：在OAuth同意屏幕页面上，单击 发布应用程序 → 确认。由于这是一个只有您会使用的个人应用程序，因此无需担心审核过程。
步骤5：创建OAuth凭据
- 首选 API和服务→ 凭证
- 点击 +创建凭据 → OAuth客户端ID
- 将应用程序类型设置为 桌面应用程序
- 随便命名（例如，“克劳德代码”）
- 点击 创建
- 复制 客户端ID 和 客户端密钥 --下一步你需要它们
步骤6：使用Claude代码注册MCP服务器
打开终端，导航到使用Claude Code的目录，然后运行：
claude mcp add google-workspace \
-e GOOGLE_OAUTH_CLIENT_ID="YOUR_CLIENT_ID" \
-e GOOGLE_OAUTH_CLIENT_SECRET="YOUR_CLIENT_SECRET" \
-e OAUTHLIB_INSECURE_TRANSPORT=1 \
-- uvx workspace-mcp --tool-tier core
替换 YOUR_CLIENT_ID 和 YOUR_CLIENT_SECRET 使用步骤5中的值。
重要提示： MCP服务器的作用域为您运行此命令的任何目录。如果稍后从其他目录启动Claude Code，它将看不到服务器。从您通常工作的目录（或父目录）运行该命令。
步骤7：重新启动并验证
- 完全退出Claude Code并重新启动它
- 推荐： 复制上一个会话中的对话，并将其粘贴到新会话中。这为Claude提供了您所设置内容的完整上下文，因此它可以从您停止的地方继续。
- 问克劳德一些使用谷歌的事情（例如，“总结我最近的5封电子邮件”）
- 浏览器窗口将打开，要求您使用Google登录
- 完成登录并授予权限
- 返回您的终端——克劳德现在应该可以访问了
故障排除
“未配置MCP服务器”
原因： 你跑了 claude mcp add 从与启动Claude Code不同的目录。服务器注册是目录范围的。
修复： cd 进入使用Claude Code的目录，然后重新运行 claude mcp add 步骤6中的命令。
realpath: command not found （macOS蒙特利）
原因： MCP服务器的包装器脚本调用 realpath -- "$0" 查找其捆绑的Python解释器，但macOS Monterey不附带 realpath （这是一个GNU coreutils实用程序）。
错误如下：
realpath: command not found
/Users/you/.cache/uv/archive-v0/.../bin/workspace-mcp: line 2
修复： 创建一个 realpath 包装在 /usr/local/bin/realpath:
sudo tee /usr/local/bin/realpath > /dev/null << 'EOF'
#!/bin/sh
# Handle -- option separator like GNU realpath
for arg in "$@"; do
case "$arg" in
--) continue ;;
-*) continue ;;
*) python3 -c "import os,sys; print(os.path.realpath(sys.argv[1]))" "$arg"; exit $? ;;
esac
done
EOF
sudo chmod +x /usr/local/bin/realpath
为什么是循环？ 一个更简单的单行中断是因为包装器脚本通过了
--在路径之前。如果不处理该分隔符，脚本将解析--作为文件名，并产生错误的路径。
创建文件后，重新启动Claude Code，MCP服务器应成功启动。
学分
- MCP服务器： taylorwilsdon/google_workspace_mcp
- Python运行程序： 星光散射/紫外线
