Google Workspace MCP

社区

用自然语言控制 Google Workspace。

分类: 团队协作第 23 / 55
Stars: ★ 3.4k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Python 3.10+ · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 17 天前
工具数: 29

56FMRS · C

基于提供的仓库说明和 server.json，该项目是活跃的第三方 Google Workspace MCP 服务器，版本 1.22.2，PyPI 包为 workspace-mcp，采用 stdio 和 streamable HTTP。它覆盖面广、可自托管且使用 MIT 许可证，但需要用户自行配置 Google Cloud、OAuth 和 API 权限；Google Chat 还存在额外账号与应用配置要求。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

12/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 清单声明了一个 PyPI stdio 包，但提供的材料没有源文件、CI 工作流或已提交测试来验证初始化、工具列表握手、依赖安装和错误处理。README 展示了大量工具及多种传输模式，却不足以证明声明与实际行为一致；因此仅给出可行性中低分，并因缺乏可执行证据、可能的文档与清单差异以及未验证的边界情况而扣分。
安全与权限 10/20: 材料显示支持 OAuth、只读模式、按服务权限、路径限制、无状态模式和网络边界控制，这些是积极证据。与此同时，README 自述公开部署时动态客户端注册默认允许任意重定向 URI，且列出发送邮件、修改共享权限、删除资源、执行 Apps Script 等高影响操作；没有提供代码证据证明危险操作需要确认、权限隔离和所有数据流均受约束。未发现明确红线行为，但这些未验证风险导致显著扣分。
维护活跃度 12/20: 仓库未归档，提供了 MIT 许可证、当前版本 1.22.2、明确维护者标识，并有较多公开 issue，表明项目仍在维护。可是材料没有提交记录、发布频率、依赖更新历史、漏洞响应流程或安全联络渠道，因此无法支持高分。
文档质量 14/20: README 覆盖安装、OAuth 配置、服务启用、工具分层、环境变量、部署模式、客户端连接和若干限制，且披露了 Chat 账号要求、远程附件限制、DCR 重定向风险等。扣分点包括工具参数和错误语义不完整、成本与配额说明有限、部分配置较复杂，以及 uvx/同名 PyPI 包和不同启动方式可能造成混淆；README 本身也不能替代源代码验证。
安装易用性 12/20: 从运行时、uv/uvx、Google Cloud 项目、OAuth 凭据到主流客户端连接均有步骤和示例，基本路径清晰。由于需要手动启用多个 API、配置 OAuth 同意与重定向、处理传输和认证模式，并存在 Chat 的额外配置及启动方式注意事项，流程仍较脆弱；且没有 CI 或测试证据验证安装和连接可复现，因此按静态校准不超过 15 分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络修改第三方账户数据

适合谁

需要集中访问多个 Google Workspace 服务的个人用户和团队。
需要按工具层级、服务或权限范围部署的开发者。
需要自托管、多用户 OAuth 2.1 或容器化部署的组织。
希望通过 CLI 调用 MCP 工具的开发者。

不适合谁

需要官方 Google 维护服务器的用户。
只有个人 @gmail.com 账号且需要 Google Chat 的用户。
不希望配置 Google Cloud OAuth 凭据或启用相关 API 的用户。
需要未经授权访问 Google Workspace 数据的应用。

所需权限

需要 Google Cloud OAuth 客户端凭据。
所需 Google API 的 OAuth 权限取决于启用的服务和工具。
支持只读权限、按服务的细粒度权限和完整访问权限。
Drive、Gmail 等写入工具需要相应写入权限。
Google Chat 需要配置 Chat 应用，并使用 Google Workspace 账号。
可选的服务账号模式需要服务账号凭据和域范围委派。

风险与副作用

启用完整工具和写入权限可能允许修改、发送、删除或共享用户数据。
公开部署时，未限制动态客户端注册的重定向 URI 可能带来钓鱼风险。
stdio 是旧版回退模式；远程或共享部署应使用 OAuth 2.1。
本地附件和凭据存储会写入配置的本地目录；无状态模式不写入文件。
Google API 配额、OAuth 同意配置和账号权限可能限制功能。
Chat API 对个人 Gmail 账号不可用。

安装接入

准备工作

运行环境：Python 3.10+ · Docker

GOOGLE_OAUTH_CLIENT_ID 必填 Google Cloud Console 中 OAuth 客户端的 ID，必需。

GOOGLE_OAUTH_CLIENT_SECRET 必填密钥同一 OAuth 客户端的密钥，来自 Google Cloud Console。

FASTMCP_SERVER_AUTH_GOOGLE_JWT_SIGNING_KEY 可选密钥 OAuth 2.1 模式下用于签署 JWT 的密钥，可用 openssl rand -hex 32 生成。

其他可选配置项（4 个）

OAUTHLIB_INSECURE_TRANSPORT 可选设为 1 允许本地 HTTP 环境下进行 OAuth 测试，仅限开发使用。

MCP_ENABLE_OAUTH21 可选设为 true 启用无密钥的 OAuth 2.1 (PKCE) 模式。

WORKSPACE_MCP_PORT 可选 HTTP 传输模式的服务端口，默认示例为 8000。

GOOGLE_OAUTH_REDIRECT_URI 可选 OAuth 回调地址，通常为 http://localhost:8000/oauth2callback。

需要 Python 3.10+、uv/uvx 和 Google Cloud 项目中的 OAuth 2.0 凭据。设置 GOOGLE_OAUTH_CLIENT_ID；机密客户端设置 GOOGLE_OAUTH_CLIENT_SECRET。可使用 uvx workspace-mcp 启动 stdio，或使用 uvx workspace-mcp --transport streamable-http 启动推荐的 HTTP 模式。现代客户端推荐使用 streamable HTTP 和 OAuth 2.1；Claude Desktop 也可通过 Connector 连接。启用具体 Google API，并为 Chat 额外配置 Chat 应用；Chat 仅支持 Google Workspace 账号。

claude_desktop_config.json

{"mcpServers":{"google_workspace":{"command":"uvx","args":["workspace-mcp"],"env":{"GOOGLE_OAUTH_CLIENT_ID":"your-client-id","GOOGLE_OAUTH_CLIENT_SECRET":"your-secret","OAUTHLIB_INSECURE_TRANSPORT":"1"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "google_workspace": {
      "command": "uvx",
      "args": [
        "workspace-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-secret",
        "OAUTHLIB_INSECURE_TRANSPORT": "1"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add google_workspace -e GOOGLE_OAUTH_CLIENT_ID=your-client-id -e GOOGLE_OAUTH_CLIENT_SECRET=your-secret -e OAUTHLIB_INSECURE_TRANSPORT=1 -- uvx workspace-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动后让客户端调用 search_gmail_messages，若能返回你邮箱中的邮件结果即说明 OAuth 连接成功；也可运行 uv run workspace-cli list 确认工具已注册。

常见排障

确认 Python 版本至少为 3.10，并已安装 uv/uvx。
检查 OAuth 客户端 ID、客户端密钥、重定向 URI 和开发环境中的 OAUTHLIB_INSECURE_TRANSPORT。
确认所需 Google API 已在 Google Cloud 项目中启用。
若 Chat 工具失败，确认已配置 Chat 应用的名称、头像 URL 和描述，并使用 Workspace 账号。
现代客户端优先使用 --transport streamable-http；OAuth 2.1 不能与 --single-user 或服务账号模式组合。
远程服务器处理附件时，应发送 Base64 内容，而不是依赖客户端本地文件路径。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索我 Gmail 里最近的未读邮件并列出标题
查一下我日历这周有哪些日程
在我的 Drive 里搜索包含'季度报告'的文件并读取内容
新建一个 Google 文档，写入会议纪要草稿

工具能力 29

search_gmail_messages 只读

使用 Gmail 查询运算符搜索邮件。

send_gmail_message 写入

发送电子邮件，并支持文件附件。

get_events 只读

按时间范围获取日历事件。

manage_event 写入

创建、更新或删除日历事件。

search_drive_files 只读

使用查询语法搜索 Drive 文件。

get_drive_file_content 只读

读取 Office 文件、PDF 和图像内容。

create_drive_file 写入

创建文件或从 URL 获取文件。

manage_drive_access 写入

授予、更新、撤销权限或转移所有权。

展开其余 21 个工具

get_doc_content 只读

提取 Google Docs 文档文本。

create_doc 写入

创建新文档。

modify_doc_text 写入

插入、替换并格式化文档文本。

read_sheet_values 只读

读取电子表格单元格范围。

modify_sheet_values 写入

写入、更新或清除单元格。

create_spreadsheet 写入

创建新电子表格。

format_sheet_range 写入

设置单元格颜色、数字格式、对齐方式和字体样式。

create_presentation 写入

创建新演示文稿。

get_presentation 只读

获取演示文稿详情。

create_form 写入

创建新表单。

list_form_responses 只读

分页列出表单回复。

list_tasks 只读

按条件列出任务。

manage_task 写入

创建、更新、删除或移动任务。

search_contacts 只读

按姓名、电子邮件或电话搜索联系人。

manage_contact 写入

创建、更新或删除联系人。

get_messages 只读

获取 Google Chat 空间中的消息。

send_message 写入

向 Chat 空间发送消息。

search_messages 只读

搜索 Chat 历史记录。

search_custom 只读

通过 Google Programmable Search Engine 执行网页搜索。

list_script_projects 只读

列出可访问的 Apps Script 项目。

run_script_function 写入

使用参数执行 Apps Script 函数。

使用场景

搜索和处理 Gmail 邮件。

管理日历事件和空闲/忙碌信息。

读写 Drive 文件、Docs、Sheets 和 Slides。

创建和处理 Forms、Tasks、Contacts 与 Chat 内容。

通过 Apps Script 执行跨应用自动化。

使用 Custom Search 执行可配置的网站搜索。

支持客户端

Claude Desktop

Claude Code

VS Code

LM Studio

依据项目文档列出，未经本站实测。

详细介绍

Google Workspace MCP Server 是一个 MIT 许可的开源 MCP 服务器和 CLI 工具，可通过 Google API 为 AI 助手提供 Gmail、Drive、Calendar、Docs、Sheets、Slides、Forms、Tasks、Contacts、Chat、Apps Script 和 Custom Search 能力。它支持分级工具、按服务选择、只读模式、细粒度权限、OAuth 2.0/2.1，以及面向多用户部署的无状态模式。