google_workspace_mcp

让AI直接操控你的Gmail和日历，办公自动化一步到位

这是一个基于MCP（模型上下文协议）的Google Workspace集成服务器，让AI助手（如Claude、ChatGPT等）能够直接操控Gmail、日历、文档、表格、幻灯片、聊天、表单、任务、搜索和云端硬盘等Google服务。它解决了AI无法安全访问和操作个人或企业Google数据的问题，通过标准化的MCP协议提供了一套命令行工具和服务器，使AI能执行发送邮件、创建日程、编辑文档、管理表格等具体操作。核心能力包括全面的服务覆盖、细粒度的权限控制、支持OAuth认证、可本地部署以保护数据隐私，并提供了清晰的工具命名和错误处理机制，方便开发者集成到自定义AI工作流中。

开源 freemium 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3214

维护状态活跃

是否开源是

定价模式 freemium

项目数据

分类对话助手

开发团队taylorwilsdon

所属国家

官网地址https://workspacemcp.com

GitHubhttps://github.com/taylorwilsdon/google_workspace_mcp

定价模式freemium

价格说明提供免费基础功能，高级功能需订阅，具体价格见官网。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型ai,chatgpt,claude,claude-code,claude-desktop,gmail,google-calendar,google-chat,google-docs,google-drive,google-forms,google-sheets,google-tasks,google-workspace,gsuite,llm,llm-tools,mcp,mcp-server,model-context-protocol-server

GitHub 星标★ 3214

30天Star增速

HF 下载量

上线时间2025-04-27 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：进阶约 15 分钟部署方式：Docker 6 步

环境要求

Docker 环境（README 提供 docker build / docker run 部署方式）
Google Cloud Console 中创建好的 OAuth 客户端凭据
已在 Google Cloud 项目中启用准备使用的服务对应 API（如 Gmail、Calendar、Drive 等）
一个支持 MCP 的客户端（Claude Code、Claude Desktop、ChatGPT Developer Mode、VS Code、LM Studi

安装与启动步骤

1创建 OAuth 凭据

在 Google Cloud Console 创建 OAuth 客户端，并启用你计划使用服务对应的 API；官方 quick start 约五分钟走完。
2获取项目代码

把仓库克隆到本地，后续构建镜像和安装 Claude 技能都在仓库根目录执行。
```
git clone https://github.com/taylorwilsdon/google_workspace_mcp.git
cd google_workspace_mcp
```
3构建 Docker 镜像

在仓库根目录构建名为 workspace-mcp 的镜像，README 的 Docker 命令即此写法。
```
docker build -t workspace-mcp .
```
4启动容器

映射 8000 端口运行服务，客户端通过该端口以 streamable HTTP 方式连接。
```
docker run -p 8000:8000 workspace-mcp
```
5安装 Claude 技能

可选步骤：把仓库自带技能软链到 Claude 技能目录，改善 Workspace 工具路由。
```
ln -s "$(pwd)/skills/managing-google-workspace" ~/.claude/skills/managing-google-workspace
```
6连接 MCP 客户端

在客户端中按官方 guides 配置连接：推荐 streamable HTTP，也支持 stdio；ChatGPT 走 Developer Mode。

关键配置

配置项	必填	说明	示例
`WORKSPACE_EXTERNAL_URL`	否	反向代理自托管时使用的外部访问地址	`https://workspace.example.com`
`WORKSPACE_MCP_ALLOW_NULL_ORIGIN_CONSENT`	否	绕过 nginx 场景下 Origin: null 同意问题的开关	`true`
`WORKSPACE_MCP_MAX_FILE_BYTES`	否	限制单次下载载荷字节数，防止大文件全部缓冲进内存；0 或未设置表示不限制	`5242880`
`.env.oauth21`	否	高级 OAuth 2.1 部署可调 FastMCP 提前刷新阈值与访问令牌有效期	`参见仓库 .env.oauth21`

如何确认成功

容器正常启动并监听 8000 端口，MCP 客户端能成功连接并列出 Workspace 工具、调用成功即部署完成。

常见问题

Q：必须付费的 Google Workspace 账号才能用吗？

A：不需要。README 明确支持所有免费 Google 账号以及各档 Google Workspace 套餐，并额外提供 Chat、Spaces 等应用选项。

Q：哪些 MCP 客户端可以连接？

A：所有 MCP 客户端都支持，推荐 streamable HTTP，也支持 stdio。ChatGPT 通过 Developer Mode 接入，VS Code、LM Studio、Open WebUI 等都有对应指南。

Q：不想自己部署怎么办？

A：官方提供托管云实例，起价每月 5 美元，详情见 workspacemcp.com 的 cloud 页面。

Q：大文件下载把内存吃满怎么办？

A：设置 WORKSPACE_MCP_MAX_FILE_BYTES 为正整数字节数（如 5242880 表示 5 MiB），超过则拒绝下载；填非法值或负数会导致服务启动失败。

Q：远程或共享端点必须加认证吗？

A：是。远程或共享 HTTP 端点需要 OAuth 2.1 bearer token，README 还支持外部 OAuth 提供方、服务账号域级委派、可信网关身份等模式。

注意事项

README 节选未给出 pip 安装或本地命令行启动的完整命令，本文步骤只依据其明确写出的 Docker 与技能软链命令。
远程或共享 HTTP 端点务必启用 OAuth 2.1 bearer token；无状态容器模式可实现零磁盘写入，适合受限环境。
反向代理部署需留意 WORKSPACE_EXTERNAL_URL、nginx 的 Origin: null 同意问题以及 Referrer-Policy 陷阱。
更多认证模式、环境变量完整清单与 OAuth 代理存储后端（内存/磁盘/Valkey/Redis）请查阅 workspacemcp.com 官方文档。

核心亮点

覆盖Google全家桶，从邮件到云端硬盘一网打尽
基于MCP标准协议，无缝对接Claude、ChatGPT等主流AI
支持OAuth安全认证，数据隐私可控可本地部署

不足之处

依赖MCP生态成熟度，非MCP环境集成成本高
文档/社区待观察

适用场景

个人助理：用自然语言让AI帮你管理邮件和日程
企业自动化：将Google Workspace操作嵌入内部AI工作流
开发者工具：快速构建基于Google数据的AI应用原型

替代项目

googleapis-for-mcp、gmail-mcp-server、workspace-mcp

项目介绍

google_workspace_mcp 是智能体领域的开源项目，由 taylorwilsdon 开发，2025 年首次发布。

在全站 13,109 个收录项目中，它的 GitHub 星标数（3,214）位列前 30%，在智能体分类的 2,520 个项目里位列前 13%。

近 42 天，它的 GitHub 星标从 3,004 增加到 3,214，净增 210。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。提供免费基础功能，高级功能需订阅，具体价格见官网。从国内网络环境看，可直接访问。

它主要面向的使用场景是：个人助理：用自然语言让AI帮你管理邮件和日程。同类可对比的替代方案包括 googleapis-for-mcp、gmail-mcp-server、workspace-mcp。

上一篇：codexpro

下一篇：mcp-use