星战科技xingzhan.cloud
返回市场
谷歌工作区MCP

谷歌工作区MCP

作者：taylorwilsdon922 星标更新：2025-11-13
安装使用来源：spider==github.com

项目介绍

<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" />

License: MIT Python 3.10+ PyPI PyPI Downloads Website

通过所有 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> <sub><sup>← 在 Claude 桌面中点击配置</sup></sub></summary> <table> <tr><td width="50%" valign="top">

必要

变量目的
GOOGLE_OAUTH_CLIENT_ID来自 Google Cloud 的 OAuth 客户端 ID
GOOGLE_OAUTH_CLIENT_SECRETOAuth 客户端密钥
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> <sub><sup>← OAuth 2.0 凭证及 API 启用</sup></sub></summary> <table> <tr> <td width="33%" align="center">

1. 创建项目

console.cloud.google.com

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

<sub>打开控制台 →</sub>

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

2. OAuth 凭证

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

<sub>下载并保存凭证</sub>

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

3. 启用 API

APIs & Services → 库

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

<sub>见下方快速链接</sub>

</td> </tr> <tr> <td colspan="3"> <details> <summary>≡ <b>OAuth 凭证设置指南</b> <sub><sup>← 分步说明</sup></sub></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> <sub><sup>← 一键启用每个 Google API</sup></sub></summary> 您可以通过点击以下链接来启用每个 API（确保您已登录 Google Cloud 控制台并且选择了正确的项目）： </details> </details>

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

  1. 环境配置：
<details open> <summary>◆ <b>环境变量</b> <sub><sup>← 配置您的运行时环境</sup></sub></summary> <table> <tr> <td width="33%" align="center">

◆ 开发模式

export OAUTHLIB_INSECURE_TRANSPORT=1

<sub>允许 HTTP 重定向 URI</sub>

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

@ 默认用户

export USER_GOOGLE_EMAIL=\
  your.email@gmail.com

<sub>单用户认证</sub>

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

◆ 自定义搜索

export GOOGLE_PSE_API_KEY=xxx
export GOOGLE_PSE_ENGINE_ID=yyy

<sub>可选：搜索 API 设置</sub>

</td> </tr> </table> </details>
  1. 服务器配置：
<details open> <summary>◆ <b>服务器设置</b> <sub><sup>← 自定义端口、URI 和代理</sup></sub></summary> <table> <tr> <td width="33%" align="center">

◆ 基础配置

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

<sub>服务器 URL 和端口设置</sub>

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

↻ 代理支持

export MCP_ENABLE_OAUTH21=
  true

<sub>利用多用户 OAuth2.1 客户端</sub>

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

@ 默认电子邮件

export USER_GOOGLE_EMAIL=\
  your.email@gmail.com

<sub>单用户模式下跳过身份验证流程中的电子邮件</sub>

</td> </tr> </table> <details> <summary>≡ <b>配置详情</b> <sub><sup>← 了解更多关于每个设置</sup></sub></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> <sub><sup>← 启用网络搜索功能</sup></sub></summary> <table> <tr> <td width="33%" align="center">

1. 创建搜索引擎

programmablesearchengine.google.com
/controlpanel/create

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

<sub>打开控制面板 →</sub>

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

**2. 获取 API