Google Workspace MCP 服务器

通过单个 MCP 服务器为 AI 智能体提供对 Google Workspace（Gmail、日历、云端硬盘等）的完全访问权限，该服务器处理多账户凭据路由、AI 消费的响应格式化以及上下文指导。

基于 Google 官方 Workspace CLI (gws) 构建，这意味着 API 覆盖范围会随着 Google 的更新而扩展。该服务器使用基于清单的工厂模式，将声明式 YAML 转换为功能齐全的 MCP 工具——添加新的 Google API 操作只需更改配置，无需更改代码。

为什么选择此 MCP 服务器

对于用户： 一次安装即可让您的 AI 智能体获得对您 Google 账户的真实、经过认证的访问权限。搜索电子邮件、查看日历、管理云端硬盘文件、串联多步工作流程——一切皆可通过自然对话完成。

对于团队： 多账户支持意味着您的智能体可以同时跨个人和工作账户工作，并具有账户级凭据隔离和符合 XDG 标准的存储。

对于开发者： 工厂架构意味着覆盖范围扩展迅速。Google 的 Workspace CLI 已经支持 15+ 项服务和数百个 API 操作。清单决定了暴露哪些操作，补丁添加特定领域的格式化，默认设置处理其余所有内容。

Related MCP server: MCP G Suite Integration

可用功能

5 个工具，涵盖 3 个核心服务的 32+ 个操作：

工具	操作	功能
`manage_email`	search, read, send, reply, replyAll, forward, triage, trash, untrash, modify, labels, threads, getThread	完整的 Gmail 功能——搜索、阅读、撰写、会话管理、标签管理
`manage_calendar`	list, agenda, get, create, quickAdd, update, delete, calendars, freebusy	日历 CRUD、自然语言事件创建、可用性检查
`manage_drive`	search, get, upload, download, copy, delete, export, listPermissions, share, unshare	文件管理、Google 文档导出、共享和权限
`manage_accounts`	list, authenticate, remove, status, refresh, scopes	多账户生命周期——添加账户、管理凭据和作用域
`queue_operations`	—	使用 `$N.field` 结果引用按顺序串联操作

每个响应都包含后续步骤指导——智能体始终知道接下来可以做什么。

工作原理

                          ┌─────────────────────────┐
MCP Client ──stdio──▶     │  manifest.yaml           │
                          │  (52 operations declared) │
                          └────────┬────────────────┘
                                   │
                          ┌────────▼────────────────┐
                          │  Factory Generator       │
                          │  schemas + handlers      │
                          └────────┬────────────────┘
                                   │
                    ┌──────────────┼──────────────┐
                    ▼              ▼              ▼
              ┌──────────┐  ┌──────────┐  ┌──────────┐
              │  Gmail   │  │ Calendar │  │  Drive   │
              │  Patch   │  │  Patch   │  │  Patch   │
              └────┬─────┘  └────┬─────┘  └────┬─────┘
                   │             │             │
                   └──────┬──────┘──────┬──────┘
                          ▼             ▼
                    Account Router ──▶ gws CLI ──▶ Google APIs

工厂在启动时读取 YAML 清单并生成 MCP 工具架构和请求处理程序。补丁在需要时添加特定领域的行为——例如 Gmail 搜索填充、日历格式化、云端硬盘文件类型检测。没有补丁的操作会自动获得合理的默认设置。

底层引擎是 Google 的 @googleworkspace/cli——一个封装了完整 Google Workspace API 接口的 Rust 二进制文件。MCP 服务器负责筛选要暴露的操作，并为 AI 消费调整响应格式。

安装

MCPB 捆绑包（Claude Desktop 及其他 MCP 客户端）

从最新版本下载适用于您平台的 .mcpb 捆绑包：

平台	文件
macOS (Apple Silicon)	`google-workspace-mcp-darwin-arm64.mcpb`
macOS (Intel)	`google-workspace-mcp-darwin-x64.mcpb`
Linux x64	`google-workspace-mcp-linux-x64.mcpb`
Linux ARM64	`google-workspace-mcp-linux-arm64.mcpb`
Windows x64	`google-workspace-mcp-windows-x64.mcpb`

在 Claude Desktop 中，将 .mcpb 文件拖入应用程序——它会提示您输入 Google OAuth 凭据，然后即可使用。支持 .mcpb 扩展的其他 MCP 客户端也可以通过相同方式安装。该捆绑包包含所有内容：服务器、gws 二进制文件和所有依赖项。

Claude Code / npm

npm install @aaronsb/google-workspace-mcp

或者直接运行：

npx @aaronsb/google-workspace-mcp

先决条件

Node.js 18+
Google Cloud OAuth 凭据——在 console.cloud.google.com/apis/credentials 创建：
- 创建一个 OAuth 2.0 客户端 ID（桌面应用程序）
- 启用您需要的 API（Gmail、日历、云端硬盘、表格等）
设置环境变量：

export GOOGLE_CLIENT_ID="your-client-id"
export GOOGLE_CLIENT_SECRET="your-client-secret"

MCP 客户端配置

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": ["@aaronsb/google-workspace-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Code

添加到 .mcp.json：

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": ["@aaronsb/google-workspace-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

使用方法

添加账户（打开浏览器进行 OAuth 认证）：

manage_accounts { "operation": "authenticate" }

然后使用您的账户邮箱调用任何工具：

manage_email    { "operation": "triage", "email": "you@gmail.com" }
manage_calendar { "operation": "agenda", "email": "you@gmail.com" }
manage_drive    { "operation": "search", "email": "you@gmail.com", "query": "quarterly report" }

多步工作流程

使用结果引用串联操作——上一步的输出将作为下一步的输入：

{
  "operations": [
    { "tool": "manage_email", "args": { "operation": "search", "email": "you@gmail.com", "query": "from:boss subject:review" }},
    { "tool": "manage_email", "args": { "operation": "read", "email": "you@gmail.com", "messageId": "$0.messageId" }}
  ]
}

扩展覆盖范围

服务器从 gws CLI 中发现操作，该 CLI 已经支持 15+ 项 Google 服务（表格、文档、任务、联系人、聊天等）。添加覆盖范围只需编辑清单：

make manifest-discover   # Find all 287+ available operations
make manifest-lint       # Validate the curated manifest
make test                # Verify everything works

新的操作会自动获得默认格式。仅在需要特定领域的呈现方式时才添加补丁。

数据存储

遵循 XDG 基础目录规范：

数据	位置
账户注册表	`~/.config/google-workspace-mcp/accounts.json`
凭据	`~/.local/share/google-workspace-mcp/credentials/`

凭据是每个账户的文件，包含标准的 OAuth 令牌。项目目录中不会存储任何机密信息。

许可证

MIT

Google Workspace MCP Server