google_workspace_mcp

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

开源 🏷️基础免费，高级付费 ✅ 目前可打开对话助手 🍴 复刻 1105 🐛 待处理 90 👀 关注 20

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3502

维护状态活跃

是否开源开源

定价模式 🏷️基础免费，高级付费支持限时试用 · 提供免费基础功能，高级功能需订阅，具体价格见官网。

项目预览

google_workspace_mcp 项目界面预览图 — 图片来源：项目官网

项目数据

分类对话助手

开发团队taylorwilsdon

官网地址https://workspacemcp.com

GitHubhttps://github.com/taylorwilsdon/google_workspace_mcp

定价模式🏷️基础免费，高级付费

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

访问状态✅ 目前可打开

是否开源是

开源协议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 星标★ 3502

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

代码更新2026-11-09

仓库体积20.1 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-09

浏览次数3

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3502

技术标签

ai chatgpt claude claude-code claude-desktop

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 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 官方文档。