gwMCP (Gambinoo3005)

gwmcp

Google Workspace MCP服务器，具有引导设置和无缝身份验证功能。

安装、验证和开始使用的一个命令 114谷歌工作区工具 使用Claude Code、Cursor或任何MCP客户端。

源自 taylorwilsdon/google_workspace_mcp （麻省理工学院）。此项目为本地单用户设置添加了一个引导设置向导、简化的配置和改进的身份验证流程。

______________________________________________________________________

目录

• 快速开始
• 逐步安装Google Cloud
• 所得
• 配置
• CLI选项
• 如何改进原版
• 发展
• 许可证

______________________________________________________________________

快速开始

如果你已经有了 client_secret.json 从Google Cloud，您可以跳过以下步骤：

uvx gwmcp setup --email you@gmail.com --client-secret /path/to/client_secret.json

如果你还没有，请按照下面的分步指南进行操作。

______________________________________________________________________

逐步安装Google Cloud

本节将带您从头开始了解所有内容。无需谷歌云经验。

1.安装先决条件

你需要 Python 3.10+ 和 紫外线 （一个快速的Python包管理器）。

Windows（PowerShell）：

# Install uv
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS/Linux：

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

安装后，重新启动终端，以便 uvx 命令可用。

2.创建谷歌云项目

1. 首选 谷歌云控制台
2. 使用您的Google帐户登录
3. 点击页面顶部的项目下拉列表（可能显示“选择项目”）
4. 点击 新项目
5. 为其命名（例如“我的工作区MCP”），然后单击 创建
6. 确保在下拉列表中选择了新项目

3.启用谷歌API

您需要为要使用的Google服务打开API。

1. 在Google Cloud控制台中，转到 API和服务>库 （或 点击此处)
2. 点击并点击，搜索并启用您需要的每个API 启用:

您可以只启用现在需要的选项，稍后添加更多。

4.设置OAuth同意屏幕

这告诉谷歌你的应用程序是什么以及谁可以使用它。

1. 首选 API和服务>OAuth同意屏幕 （或 点击此处)
2. 选择 开始 或 外部的 作为用户类型，然后单击 创建
3. 填写必填字段：

- 应用名称：任何东西（例如“gwmcp”） - 用户支持电子邮件：您的电子邮件 - 开发人员联系电子邮件：您的电子邮件

1. 点击 保存并继续 通过“范围”和“摘要”步骤（默认值很好）
2. 在 测试用户 页面或下方 观众，单击 添加用户
3. 添加您自己的Gmail地址（例如。 you@gmail.com)然后单击 保存

重要提示： 当应用程序处于“测试”模式时，只有您添加为测试用户的电子邮件地址可以进行身份验证。这适合个人使用。

5.创建OAuth凭据

这产生了 client_secret.json 你需要的文件。

1. 首选 API和服务>凭据 （或 点击此处)
2. 点击 创建凭据 在顶端
3. 选择 OAuth客户端ID
4. 对于 应用程序类型，选择 桌面应用
5. 为其命名（例如“gwmcp”）并单击 创建
6. 将出现一个对话框，其中包含您的客户端ID和密码--单击 下载JSON
7. 将下载的文件保存在您可以找到的地方（例如您的下载文件夹）

文件将有一个长名称，如 client_secret_284692452895-xxxxx.apps.googleusercontent.com.json这很正常。

6.运行安装向导

现在你有你需要的一切。在终端中运行以下命令：

uvx gwmcp setup --email you@gmail.com --client-secret ~/Downloads/client_secret_*.json

替换 you@gmail.com 使用您的实际Gmail地址，并更新保存JSON文件的路径。

向导将：

1. 将您的凭据复制到安全位置(~/.google_workspace_mcp/)
2. 打开浏览器进行谷歌登录
3. 保存身份验证令牌
4. 为Claude Code编写MCP配置文件

浏览器打开时：

• 使用您作为测试用户添加的同一Google帐户登录
• 你会看到一条警告：“谷歌尚未验证此应用程序”——点击 高级那么 转到gwmcp（不安全）
• 检查权限并单击 允许
• 您将看到一个成功页面——您可以关闭浏览器选项卡

7.重新启动克劳德代码

关闭并重新打开Claude Code。谷歌工作区工具现在将可用。试着问：

“在我的Google Drive中搜索最近的文档”

或者，如果您更喜欢交互式设置（每一步都会提示您）：

uvx gwmcp setup

______________________________________________________________________

所得

12个Google Workspace服务中的114个工具：

______________________________________________________________________

配置

之后 gwmcp setup，你的 ~/.claude/mcp.json 看起来像：

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": ["gwmcp", "--single-user"],
      "env": {
        "GOOGLE_CLIENT_SECRET_PATH": "/path/to/.google_workspace_mcp/client_secret.json"
      }
    }
  }
}

仅 一个环境变量 需要。从存储的令牌中自动检测电子邮件和OAuth凭据。

环境变量

______________________________________________________________________

CLI选项

gwmcp --single-user                    # Single-user mode (recommended)
gwmcp --tools gmail drive docs         # Load specific services only
gwmcp --tool-tier core                 # Load core tools only
gwmcp --read-only                      # Read-only mode
gwmcp --permissions gmail:readonly drive:full  # Granular permissions
gwmcp --cli search_drive_files --args '{"query": "test"}'  # Direct CLI usage

______________________________________________________________________

如何改进原版

______________________________________________________________________

故障排除

“谷歌尚未验证此应用程序”

这是因为您的应用程序处于“测试”模式。要克服它：

1. 点击 高级那么 转到gwmcp（不安全） 继续
2. 如果你被完全屏蔽，请确保你的电子邮件被添加为测试用户：

- 首选 谷歌云控制台 > API和服务 > OAuth 授权界面 - 在...之下 观众 （或 测试用户)，单击 添加用户 - 添加您尝试登录的Gmail地址 - 保存并重试

“访问被阻止：此应用程序的请求无效”

确保 重定向URI 比赛。gwmcp使用 http://localhost:8000/oauth2callback。您不需要在Google Cloud中为桌面应用程序凭据配置此项，它会自动处理。

“uvx：找不到命令”

你需要先安装uv。看 安装先决条件.

端口8000正在使用中

另一个应用程序正在使用端口8000。停止它并重试，或设置自定义端口：

WORKSPACE_MCP_PORT=9000 uvx gwmcp setup --email you@gmail.com --client-secret /path/to/secret.json

令牌已过期或被撤销

重新运行安装向导以重新进行身份验证：

uvx gwmcp setup

______________________________________________________________________

发展

git clone https://github.com/Gambinoo3005/gwmcp.git
cd gwmcp
pip install -e ".[dev]"
pytest

______________________________________________________________________

许可证

MIT许可证。看 许可证.

基于 google_workspace_mcp 泰勒·威尔斯顿。