Google Workspace MCP Server 的用途是让 AI 助手、MCP 客户端和开发者工具通过自然语言控制 Google Workspace 服务。它连接全部十二项主要 Workspace 服务，在单个 MCP 服务器背后提供 120 多个工具，并附带完整功能的 CLI 与 Code Mode，可用于 Claude Code、Codex 之类的工具。
主要能力方面，项目覆盖 Google Calendar、Drive、Gmail、Docs、Sheets、Slides、Forms、Tasks、Contacts 和 Chat 等，支持多用户、细粒度编辑工具。它提供三级渐进式工具层次：core 是核心功能集，extended 增加管理操作，complete 加载全部工具，用以控制上下文窗口占用。还支持 --tools <service>、--read-only、按服务的 --permissions 以及通过 --disabled-tools <name> 减去单个工具。认证方面使用原生 OAuth 2.1，支持无状态部署、外部认证服务器和网关透传认证，可面向整个组织集中、安全地托管。支持所有免费 Google 账号和 Google Workspace 套餐，并提供 Chat 与 Spaces 等扩展应用选项。项目还提供托管云实例选项，起价每月 5 美元。
使用方式上，基本流程为：设置凭据 → 选择启动命令 → 连接客户端。需要先在 Google Cloud Console 中创建 OAuth 客户端，并在项目中启用计划使用服务对应的 Google API；文档提供每个 API 的一键启用链接以及覆盖全部 API 的 gcloud services enable 命令，快速开始指南约五分钟可完成设置。客户端连接方式包括：Claude Desktop、网页版和移动版，推荐以 HTTP 模式运行服务器并添加为 Connector（设置 → Connectors → 添加自定义连接器）；旧式 stdio 配置仍可用于不支持 Connector 的客户端。ChatGPT 可通过 Developer Mode 连接。VS Code、LM Studio、Open WebUI 及其他任何 MCP 客户端可通过 streamable HTTP（推荐）或 stdio 连接。CLI 工具 workspace-cli 针对运行中的服务器列出和调用工具，带加密、磁盘支持的 OAuth 令牌缓存，一次认证即可长期脚本化使用；需从本仓库以 uv tool install . 全局安装，注意不要使用 uvx workspace-cli，因为该名称被一个已废弃的 PyPI 包占用了。
部署与高级配置方面，文档覆盖 OAuth 2.1 多用户认证（远程或共享 HTTP 端点所需 bearer token）、无状态容器模式（零磁盘写入）、OAuth 代理存储后端（内存、磁盘或 Valkey/Redis 用于分布式部署）、外部 OAuth 提供者模式、带域范围委派的 service account、可信网关身份（Pomerium、Cloudflare Access、oauth2-proxy 或任何可验证 JWKS 的网关）以及可选的 OpenTelemetry 追踪（默认关闭）。Docker 方式为 docker build -t workspace-mcp . && docker run -p 8000:8000 workspace-mcp。生产环境调优通过环境变量完成，例如 Google API 请求的 WORKSPACE_MCP_GOOGLE_API_WORKERS、WORKSPACE_MCP_GOOGLE_API_TIMEOUT_SECONDS，外部 OAuth 令牌验证的 WORKSPACE_MCP_TOKEN_VALIDATION_WORKERS、WORKSPACE_MCP_TOKEN_VALIDATION_CACHE_TTL，内存上限的 WORKSPACE_MCP_MAX_FILE_BYTES、WORKSPACE_MCP_STATELESS_INLINE_MAX_BYTES、WORKSPACE_MCP_MAX_OFFICE_XML_BYTES，会话与健康探测的 WORKSPACE_MCP_SESSION_IDLE_TIMEOUT、WORKSPACE_MCP_READINESS_TIMEOUT_SECONDS，以及无调用方磁盘访问的托管服务器使用 WORKSPACE_MCP_DISABLE_LOCAL_FILES。对于下载、水平扩展或缩容至零的 HTTP 部署（Cloud Run、Kubernetes），可安装 gcs extra 并设置 WORKSPACE_MCP_FILES_GCS_BUCKET，附件将暂存到 Google Cloud Storage，对象写在 WORKSPACE_MCP_FILES_GCS_PREFIX（默认 attachments）下，并以有效期一小时的 V4 签名 URL 提供。
适用场景包括：个人用户用 AI 管理邮件、日历、文档、表格等；团队或组织集中托管 Workspace AI 集成；开发者构建相关自动化或集成产品；以及在需要多用户、细粒度权限控制的生产环境中部署。
限制与注意事项方面，Google Chat 需要一次性配置 Chat 应用，并需要 Workspace 账号。默认情况下服务器仅代表已认证用户向 Google API 发送数据，不使用自有 OAuth 客户端凭据之外的任何上报、分析、许可服务器或 SaaS 依赖；可选追踪默认关闭。项目采用 MIT 许可，无 CLA、无双重许可、无 copyleft。安全上提示注入风险真实存在，邮件、文档和事件可能包含隐藏指令，应只连接可信数据并谨慎启用写入工具。切勿将 .env、client_secret.json 或 .credentials/ 提交到源代码管理。本地文件读取默认沙箱在受管理的附件目录，即便扩宽 ALLOWED_FILE_DIRS，.env*、~/.ssh/、~/.aws/ 等敏感路径也始终被阻止。生产部署应使用 HTTPS 和 OAuth 2.1。关于域名、具体 API 清单、各工具参数与作用域等更完整参考，资料中未逐一列出，可在项目文档中查看。