<div align="center">

<span style="color:#cad8d9">Google Workspace MCP 服务器</span> <img src="https://gips0.baidu.com/it/u=1164705574,1941228568&fm=3081&app=3081&f=PNG?w=1024&h=1024" width="80" align="right" />

通过所有 MCP 客户端、AI 助手和开发工具实现对 Google 日历、驱动器、Gmail、文档、表格、幻灯片、表单、任务和聊天的全自然语言控制。

功能最全面的 Google Workspace MCP 服务器，现在支持远程 OAuth2.1 多用户以及一键安装 Claude。

支持所有免费的 Google 账户（如 Gmail、文档、驱动器等）及 Google Workspace 计划（入门级、标准版、增强版、企业版、非营利组织版），并扩展了应用选项，如聊天和空间。 <br/> 感兴趣于私有云实例？可以安排。

</div> <div align="center"> <a href="https://glama.ai/mcp/servers/@taylorwilsdon/google_workspace_mcp"> <img width="195" src="https://gips1.baidu.com/it/u=3596433334,3156507507&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Google Workspace Server MCP 服务器" align="center"/> </a> <a href="https://www.pulsemcp.com/servers/taylorwilsdon-google-workspace"> <img width="456" src="https://gips3.baidu.com/it/u=3886695934,2148003431&fm=3081&app=3081&f=PNG?w=912&h=220" align="center"/> </a> </div>

---

实际操作演示：

<div align="center"> <video width="400" src="https://github.com/user-attachments/assets/a342ebb4-1319-4060-a974-39d202329710"></video> </div>

---

快速插件介绍：AI 增强文档

<details> <summary>◆ <b>为什么？</b></summary>

此 README 是在 AI 的帮助下编写的，以下是为什么这很重要

作为一个独立开发者，构建开源工具时，如果没有 AI 的帮助，全面的文档通常不会出现。使用像 Roo 和 Claude Code 这样的代理开发工具，它们理解整个代码库，AI 不仅仅是重复通用内容——它提取真实的实现细节，并创建准确、具体的文档。

在这种情况下，Sonnet 4 进行了一次通过，一个人类（我）在 2025 年 8 月 16 日验证了它们。

</details>

<span style="color:#adbcbc">概述</span>

一个生产就绪的 MCP 服务器，集成了所有主要的 Google Workspace 服务与 AI 助手。它支持单用户操作和通过 OAuth 2.1 的多用户身份验证，使其成为自定义应用程序的强大后端。使用 FastMCP 构建以获得最佳性能，具有高级的身份验证处理、服务缓存和简化开发模式。

简化设置：现在使用 Google 桌面 OAuth 客户端——无需重定向 URI 或端口配置！

<span style="color:#adbcbc">特性</span>

<table align="center" style="width: 100%; max-width: 100%;"> <tr> <td width="50%" valign="top">

<span style="color:#72898f">@</span> Gmail • <span style="color:#72898f">≡</span> 驱动器 • <span style="color:#72898f">⧖</span> 日历 <span style="color:#72898f">≡</span> 文档

• 完整的 Gmail 管理，从头到尾覆盖
• 具有高级功能的完整日历管理
• 文件操作，支持 Office 格式
• 文档创建、编辑和评论
• 深度、详尽的支持精细编辑

---

<span style="color:#72898f">≡</span> 表单 • <span style="color:#72898f">@</span> 聊天 • <span style="color:#72898f">≡</span> 表格 • <span style="color:#72898f">≡</span> 幻灯片

• 表单创建、发布设置和响应管理
• 空间管理和消息传递能力
• 灵活单元格管理的电子表格操作
• 创建、更新和内容操作的演示文稿

</td> <td width="50%" valign="top">

<span style="color:#72898f">⊠</span> 身份验证和安全性

• 高级的 OAuth 2.0 和 OAuth 2.1 支持
• 自动令牌刷新和会话管理
• 传输感知回调处理
• 多用户承载令牌身份验证
• 创新的 CORS 代理架构

---

<span style="color:#72898f">✓</span> 任务 • <span style="color:#72898f">◆</span> 自定义搜索 • <span style="color:#72898f">↻</span> 传输支持

• 对所有 MCP 传输的完全支持
• 层次结构的任务和任务列表管理
• 可编程搜索引擎 (PSE) 集成

</td> </tr> </table>

---

▶ 快速开始

<details> <summary>≡ <b>快速参考卡</b>← 快速查看基本命令和配置</summary> <table> <tr><td width="33%" valign="top">

⊠ 凭证

export GOOGLE_OAUTH_CLIENT_ID="..."
export GOOGLE_OAUTH_CLIENT_SECRET="..."

完整设置 →

</td><td width="33%" valign="top">

▶ 启动命令

uvx workspace-mcp --tool-tier core
uv run main.py --tools gmail drive

更多选项 →

</td><td width="34%" valign="top">

★ 工具层级

• ● 核心 - 基本工具
• ◐ 扩展 - 核心 + 额外工具
• ○ 完整 - 所有工具 详情 →

</td></tr> </table> </details>

1. 一键 Claude 桌面安装（推荐）

1. 下载：从“发布”页面获取最新的 google_workspace_mcp.dxt
2. 安装：双击文件——Claude 桌面打开并提示您安装
3. 配置：在 Claude 桌面 → 设置 → 扩展 → Google Workspace MCP 中粘贴您的 Google OAuth 凭证
4. 使用：启动新的 Claude 聊天并调用任何 Google Workspace 工具

为什么使用 DXT？

桌面扩展（.dxt）捆绑了服务器、依赖项和清单，因此用户只需点击一次即可从下载 → 正常运行的 MCP——无需终端、无需编辑 JSON、无需版本冲突。

必要配置

<details> <summary>◆ <b>环境变量</b> _{^{← 在 Claude 桌面中点击配置}}</summary> <table> <tr><td width="50%" valign="top">

必要

变量	目的
GOOGLE_OAUTH_CLIENT_ID	来自 Google Cloud 的 OAuth 客户端 ID
GOOGLE_OAUTH_CLIENT_SECRET	OAuth 客户端密钥
OAUTHLIB_INSECURE_TRANSPORT=1	开发用途（允许 http:// 重定向）

</td><td width="50%" valign="top">

可选

变量	目的
USER_GOOGLE_EMAIL	单用户认证的默认电子邮件
GOOGLE_PSE_API_KEY	自定义搜索的 API 密钥
GOOGLE_PSE_ENGINE_ID	自定义搜索的搜索引擎 ID
MCP_ENABLE_OAUTH21	设置为 true 以启用 OAuth 2.1 支持
EXTERNAL_OAUTH21_PROVIDER	设置为 true 以启用外部 OAuth 流程（需要 OAuth 2.1）
WORKSPACE_MCP_STATELESS_MODE	设置为 true 以启用无状态操作（需要 OAuth 2.1）

</td></tr> </table>

Claude 桌面安全地存储这些凭据在操作系统密钥链中；只需在扩展面板中设置一次。

</details>

---

<div align="center"> <video width="832" src="https://github.com/user-attachments/assets/83cca4b3-5e94-448b-acb3-6e3a27341d3a"></video> </div>

---

先决条件

• Python 3.10+
• uvx（用于即时安装）或 uv（用于开发）
• Google Cloud 项目，带有 OAuth 2.0 凭证

配置

<details open> <summary>◆ <b>Google Cloud 设置</b> _{^{← OAuth 2.0 凭证及 API 启用}}</summary> <table> <tr> <td width="33%" align="center">

1. 创建项目

console.cloud.google.com

→ 创建新项目
→ 记录项目名称

_{打开控制台 →}

</td> <td width="33%" align="center">

2. OAuth 凭证

APIs & Services → 凭证
→ 创建凭证
→ OAuth 客户端 ID
→ 桌面应用

_{下载并保存凭证}

</td> <td width="34%" align="center">

3. 启用 API

APIs & Services → 库

搜索并启用：
日历、驱动器、Gmail、
文档、表格、幻灯片、
表单、任务、聊天、搜索

_{见下方快速链接}

</td> </tr> <tr> <td colspan="3"> <details> <summary>≡ <b>OAuth 凭证设置指南</b> _{^{← 分步说明}}</summary>

完整设置过程：

1. 创建 OAuth 2.0 凭证 - 访问 Google Cloud 控制台

   • 创建新项目（或使用现有项目）
   • 导航至 APIs & Services → 凭证
   • 点击 创建凭证 → OAuth 客户端 ID
   • 选择 桌面应用 作为应用类型（无需重定向 URI！）
   • 下载凭证并记录客户端 ID 和客户端密钥

2. 启用所需 API - 在 APIs & Services → 库

   • 搜索并启用每个所需 API
   • 或使用下方快速链接进行一键启用

3. 配置环境 - 设置您的凭证：

   export GOOGLE_OAUTH_CLIENT_ID="your-client-id"
   export GOOGLE_OAUTH_CLIENT_SECRET="your-secret"
   

≡ 完整文档 →

</details> </td> </tr> </table> <details> <summary>⊥ <b>快速 API 启用链接</b> _{^{← 一键启用每个 Google API}}</summary> 您可以通过点击以下链接来启用每个 API（确保您已登录 Google Cloud 控制台并且选择了正确的项目）：

• 启用 Google 日历 API
• 启用 Google 驱动器 API
• 启用 Gmail API
• 启用 Google 文档 API
• 启用 Google 表格 API
• 启用 Google 幻灯片 API
• 启用 Google 表单 API
• 启用 Google 任务 API
• 启用 Google 聊天 API
• 启用 Google 自定义搜索 API

</details> </details>

1.1. 凭证：参见 凭证配置 了解详细设置选项

2. 环境配置：

<details open> <summary>◆ <b>环境变量</b> _{^{← 配置您的运行时环境}}</summary> <table> <tr> <td width="33%" align="center">

◆ 开发模式

export OAUTHLIB_INSECURE_TRANSPORT=1

_{允许 HTTP 重定向 URI}

</td> <td width="33%" align="center">

@ 默认用户

export USER_GOOGLE_EMAIL=\
  your.email@gmail.com

_{单用户认证}

</td> <td width="34%" align="center">

◆ 自定义搜索

export GOOGLE_PSE_API_KEY=xxx
export GOOGLE_PSE_ENGINE_ID=yyy

_{可选：搜索 API 设置}

</td> </tr> </table> </details>

3. 服务器配置：

<details open> <summary>◆ <b>服务器设置</b> _{^{← 自定义端口、URI 和代理}}</summary> <table> <tr> <td width="33%" align="center">

◆ 基础配置

export WORKSPACE_MCP_BASE_URI=
  http://localhost
export WORKSPACE_MCP_PORT=8000

_{服务器 URL 和端口设置}

</td> <td width="33%" align="center">

↻ 代理支持

export MCP_ENABLE_OAUTH21=
  true

_{利用多用户 OAuth2.1 客户端}

</td> <td width="34%" align="center">

@ 默认电子邮件

export USER_GOOGLE_EMAIL=\
  your.email@gmail.com

_{单用户模式下跳过身份验证流程中的电子邮件}

</td> </tr> </table> <details> <summary>≡ <b>配置详情</b> _{^{← 了解更多关于每个设置}}</summary>

变量	描述	默认值
WORKSPACE_MCP_BASE_URI	基础服务器 URI（不带端口）	http://localhost
WORKSPACE_MCP_PORT	服务器监听端口	8000
WORKSPACE_EXTERNAL_URL	反向代理设置的外部 URL	无
GOOGLE_OAUTH_REDIRECT_URI	覆盖 OAuth 回调 URL	自动生成
USER_GOOGLE_EMAIL	默认认证电子邮件	无

</details> </details>

Google 自定义搜索设置

<details> <summary>◆ <b>自定义搜索配置</b> _{^{← 启用网络搜索功能}}</summary> <table> <tr> <td width="33%" align="center">

1. 创建搜索引擎

programmablesearchengine.google.com
/controlpanel/create

→ 配置站点或整个网络
→ 记录您的引擎 ID（cx）

_{打开控制面板 →}

</td> <td width="33%" align="center">

**2. 获取 API