Google Workspace集成工具

谷歌工作区mcp-go

轻量级Go实现 谷歌工作区MCP服务器 --12个谷歌服务中的137个工具，单个自包含的二进制文件，专为本地人工智能工具使用而设计。

为什么存在

这 原始Python服务器 功能齐全，可投入生产，支持多用户OAuth 2.1、HTTP传输和分布式会话存储。这是共享/托管部署的正确选择。

这种Go重写适用于不同的用例： 单用户、本地AI工具使用 --特别是在您的计算机上运行的Claude Code、Cursor和类似的MCP客户端。如果你想用最少的内存使用和没有Python运行时开销的Google Workspace集成，这是为你准备的。

如果满足以下条件，请使用Go版本：您在本地以Claude Code或类似方式运行MCP工具，希望低内存使用率，并且不需要多用户或HTTP服务器模式。

如果满足以下条件，请使用Python版本：您需要多用户支持、OAuth 2.1、HTTP传输或托管/容器化部署。

快速开始

1.谷歌云项目设置

您需要一个具有OAuth凭据的Google Cloud项目。如果您已经使用过 原始Python服务器，同样的凭据在这里也适用。

创建OAuth凭据：

1. 去 Google 云控制台
2. 创建新项目（或选择现有项目）
3. 引导到 API和服务>OAuth同意屏幕 如果您还没有配置它，请进行配置
4. 引导到 API和服务>凭据
5. 点击 创建凭据>OAuth客户端ID
6. 选择 桌面应用程序 作为应用程序类型
7. 注意 客户端ID 和 客户端密钥

启用API 您需要（单击直接启用）：

• Gmail API
• Google Drive API
• 谷歌日历API
• 谷歌文档API
• 谷歌网页API
• 谷歌幻灯片API
• 谷歌表单API
• 谷歌任务API
• 谷歌聊天API
• 人民API（联系人）
• 应用程序脚本API
• 自定义搜索API （可选，用于网络搜索工具）

您只需要为计划使用的服务启用API。例如，如果你只需要Gmail和日历，只需启用这两个。

2.安装

下载预构建的二进制文件 （无需Go）：

去 发布 页面并下载适用于您平台的存档：

# Example: Linux x86_64
tar xzf google-workspace-mcp-go_*_linux_amd64.tar.gz
chmod +x google-workspace-mcp-go
mv google-workspace-mcp-go ~/.local/bin/  # or anywhere on your PATH

或使用Go安装 （需要Go 1.24+）：

go install github.com/magks/google-workspace-mcp-go@latest

这将二进制文件放入您的 $GOPATH/bin （通常 ~/go/bin).

或从源代码构建:

git clone https://github.com/magks/google-workspace-mcp-go.git
cd google-workspace-mcp-go
go build -o google-workspace-mcp-go .

3.配置环境

export GOOGLE_OAUTH_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"
export USER_GOOGLE_EMAIL="you@gmail.com"  # optional but recommended

您可以将这些添加到您的shell配置文件中(~/.bashrc, ~/.zshrc等等），因此它们在会话中持续存在。

4.添加到克劳德代码

二进制文件从环境变量中读取配置。如果你已经有了 GOOGLE_OAUTH_CLIENT_ID, GOOGLE_OAUTH_CLIENT_SECRET，以及 USER_GOOGLE_EMAIL 导出到运行Claude Code的shell中，您不需要在MCP配置中重复它们——二进制文件会自动拾取它们。

最小配置 （env变量已导出到shell中）：

{
  "mcpServers": {
    "google-workspace": {
      "command": "/path/to/google-workspace-mcp-go"
    }
  }
}

显式配置 （每个服务器设置环境变量，如果您不想全局导出，这很有用）：

{
  "mcpServers": {
    "google-workspace": {
      "command": "/path/to/google-workspace-mcp-go",
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-client-secret",
        "USER_GOOGLE_EMAIL": "you@gmail.com"
      }
    }
  }
}

要减少加载的工具数量（有助于保持在上下文限制内），请使用 --tools 和 --tool-tier:

{
  "mcpServers": {
    "google-workspace": {
      "command": "/path/to/google-workspace-mcp-go",
      "args": ["--tools", "gmail drive calendar", "--tool-tier", "core"]
    }
  }
}

5.首次运行--身份验证

首次使用时，您需要向Google进行身份验证：

1. 让你的人工智能助手呼叫 start_google_auth 工具与您的电子邮件
2. 浏览器窗口打开，显示谷歌的OAuth同意屏幕
3. 授权请求的权限
4. 凭据保存到 ~/.google_workspace_mcp/credentials/your-email.json
5. 后续运行会自动使用保存的凭据（令牌透明刷新）

注： start_google_auth 需要 gmail 在你的 --tools 列出（或省略 --tools 加载所有服务）。如果您使用的是没有gmail的受限工具集，请临时添加它进行初始身份验证。

配置

CLI标志

环境变量

工具层级

层级允许您控制注册的工具数量，这会影响AI助手中的上下文窗口使用情况：

可用服务

gmail drive calendar docs sheets slides forms tasks chat contacts search appscript

工具

凭据存储

凭据以JSON文件存储在 ~/.google_workspace_mcp/credentials/ （可通过以下方式配置 WORKSPACE_MCP_CREDENTIALS_DIR).每个文件都有名称 {email}.json 并且包含OAuth2令牌。

凭据目录是通过以下方式创建的 0700 权限。个人凭据文件是通过以下方式创建的 0600 权限。

测试

# Run all tests (~1100 tests, takes ~1 second)
go test ./...

# Run with verbose output
go test -v ./...

# Run tests for a specific service
go test ./tools/ -run TestGmail
go test ./tools/ -run TestDrive

# Run integration tests against real Google APIs (requires credentials)
INTEGRATION_TEST_EMAIL="you@gmail.com" go test -tags integration ./tools/

测试套件有三层，不需要网络访问（集成除外）：

• 单元测试 --用于格式化、解析和辅助逻辑的纯函数测试
• 协议测试 --发送MCP tools/call 通过服务器发送消息，验证参数验证和错误路径
• 模拟API测试 --完整的处理程序管道 httptest.Server 返回罐装的Google API响应

集成测试在后面进行 integration 生成标签并在以下情况下自动跳过 INTEGRATION_TEST_EMAIL 未设置。

局限性

• 仅限stdio传输 --无HTTP服务器模式（使用 Python版本 为此）
• 单用户 --无多用户会话管理或OAuth 2.1
• 无附件服务 --没有用于文件下载的HTTP端点
• 仅限本地使用 --专为本地MCP客户端设计，而非托管部署

致谢

这个项目是Go重写的 google_workspace_mcp 通过 泰勒·威尔斯顿最初是用Python编写的。最初的项目提供了功能齐全的实现，包括多用户支持、OAuth 2.1、HTTP传输等。在麻省理工学院获得许可。

许可证

麻省理工学院