Google Workspace MCP Go

谷歌工作区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

工具

Full tool reference (137 tools across 12 services)

Gmail（15个工具）

系统工具 （已在gmail上注册，但并非特定于gmail）：

谷歌云端硬盘（16个工具）

谷歌日历（6个工具）

谷歌文档（19个工具）

谷歌表格（14个工具）

谷歌幻灯片（9个工具）

谷歌表单（6个工具）

谷歌任务（12个工具）

谷歌聊天（4工具）

谷歌联系人（15个工具）

谷歌自定义搜索（3个工具）

谷歌应用脚本（17个工具）

凭据存储

凭据以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客户端设计，而非托管部署

致谢

许可证

麻省理工学院