谷歌工作区MCP高级版
适用于Google Workspace的生产就绪MCP服务器。
google-workspace-mcp-advanced 为MCP客户提供广泛的Google Workspace覆盖范围，默认情况下具有安全的写入操作、Markdown到Google Docs的支持以及Drive同步工作流。
为什么这个项目
- 11个服务域：Gmail、云端硬盘、日历、文档、表格、聊天、表单、幻灯片、任务、搜索、应用程序脚本
- 100多种读写操作工具
- 变异操作的模拟运行默认值
- 谷歌文档的强大Markdown渲染（厨房水槽验证）
- 持久OAuth会话和弹性认证存储
快速开始
1.安装 uv
# macOS (Homebrew)
brew install uv
# Windows (winget)
winget install --id=astral-sh.uv -e
# Windows (PowerShell installer)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# Linux/macOS (official installer)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Verify
uv --version2.从PyPI运行MCP服务器（推荐）
# Stable channel (latest release)
uvx google-workspace-mcp-advanced --transport stdio
# Pinned deterministic version (recommended for teams)
uvx google-workspace-mcp-advanced==1.0.10 --transport stdio3.添加MCP客户端配置
{
"mcpServers": {
"google-workspace": {
"command": "uvx",
"args": ["google-workspace-mcp-advanced==1.0.10", "--transport", "stdio"],
"env": {
"USER_GOOGLE_EMAIL": "your.email@company.com"
}
}
}
}4.使用特定于客户端的设置指南
5.首次运行时进行身份验证
- 从MCP客户端启动服务器。
- 运行任何谷歌工具（例如，列出日历或列出驱动器文件）。
- 在
stdio模式（默认），完成设备流程：
- 打开验证URL， - 输入用户代码， - 请重试工具调用。 - 如果您的OAuth客户端类型不支持设备流，服务器将自动回退到回调流。
- 在
streamable-http，通过打开服务器显示的OAuth URL来完成回调身份验证。
- 对于MCP托管/手动完成工作流，请使用 complete_google_auth 使用浏览器回调URL。
- 凭据保存在
~/.config/google-workspace-mcp-advanced/credentials/. - 旧目录
~/.config/gws-mcp-advanced/仍然支持迁移。
单MCP多客户端模式
通过以下方式将一个MCP条目用于多个OAuth客户端（例如私有+企业租户）：
auth_clients.json在...之下WORKSPACE_MCP_CONFIG_DIR- 确定性路由
script_clients,account_clients，以及domain_clients - 设置工具：
setup_google_auth_clients,import_google_auth_client - 完井工具：
complete_google_auth
指南：
地方发展模式
在构建或测试未发布的更改时使用存储库本地执行。
{
"mcpServers": {
"google-workspace-dev": {
"command": "uv",
"args": [
"run",
"--project",
"/path/to/google-workspace-mcp-advanced",
"google-workspace-mcp-advanced",
"--transport",
"stdio"
],
"env": {
"USER_GOOGLE_EMAIL": "your.email@company.com"
}
}
}
}服务覆盖范围
| 服务 | 示例功能 |
|---|---|
| Gmail | 搜索、阅读、草稿、发送、标签、过滤器 |
| 驱动器 | 搜索、读取、上传、权限、所有权转移 |
| 日历 | 列出/创建/修改/删除事件 |
| 文档 | 创建/更新文档、插入标记、表格和图像处理 |
| 工作表 | 读/写范围、格式、条件格式 |
| 聊天 | 列出空间，阅读/发送消息 |
| 表单 | 创建表单、读取响应、更新发布设置 |
| 幻灯片 | 创建演示文稿，批量更新 |
| 任务 | 任务列表和任务生命周期管理 |
| 搜索 | 可编程搜索端点支持 |
| 应用程序脚本 | 项目元数据/内容、版本、部署、流程、指标和默认安全变量 |
安全模型
- 修改工具默认为
dry_run=True. - 你必须通过
dry_run=False实施真正的变革。 - 这减少了辅助实验期间的意外写入。
通用运行时命令
# Run locally from repo
uv run google-workspace-mcp-advanced --transport stdio
# HTTP transport
uv run google-workspace-mcp-advanced --transport streamable-http
# Single-user mode
uv run google-workspace-mcp-advanced --single-user
# Load specific service groups only
uv run google-workspace-mcp-advanced --tools gmail drive calendar所需的环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
USER_GOOGLE_EMAIL | 是 | 目标谷歌帐户电子邮件 |
GOOGLE_OAUTH_CLIENT_ID | 对传统单客户端模式是 | OAuth客户端ID |
GOOGLE_OAUTH_CLIENT_SECRET | 是的，适用于传统单客户端模式 | OAuth客户端密钥 |
WORKSPACE_MCP_CONFIG_DIR | 否 | 配置/凭据目录覆盖 |
WORKSPACE_MCP_AUTH_FLOW | 否 | 身份验证交互模式： auto （默认）， device，或 callback |
从旧名称迁移
如果您之前以以下方式运行该项目 gws-mcp-advanced，请遵循：
文档
- 用户文档： docs/INDEX.md
- 客户端设置中心： docs/setup/MCP_CLIENT_setup_GUIDE.md
- 迁移指南： 文档/设置/迁移_FROM_GWS_MCP_ADVANCED.md
- 身份验证模型： docs/setup/AUTHENTICATION_MODEL.md
- 单MCP多客户端身份验证设置： docs/setup/MOLI_CLIENT_AUTH_setup.md
- 应用程序脚本设置和限制： docs/setup/APS_SCRIPT_setup.md
- 应用程序脚本功能和工作流程： docs/setup/APPS_SCRIPT_USER_GUIDE.md
- 应用程序脚本+扣环工作流程： docs/setup/APPS_SCRIPT_CLASP_GUIDE.md
- 克劳德代码设置： docs/setup/CLAUDE_CODE_MCP_setup.md
- 光标设置： docs/setup/CURSOR_MCP_setup.md
- OpenCode设置： docs/setup/OPENCODE_MCP_setup.md
- Gemini CLI设置： docs/setup/GEMINI_CLI_MCP_setup.md
- Cadence工作流用户指南： docs/setup/LIVE_CADENCE_WORKFLOW.md
- 分发/发布指南： docs/DISTRIBUTION_RELEASE.md
- 发行说明： docs/RELEASE_NOTES.md
- 与上游相比： docs/COMPARESON.md
贡献者文档位于 AGENTS.md 和 agent-docs/.