AI导哈

Google Workspace MCP 服务器

Google Workspace MCP 高级版是一个生产就绪的 MCP 服务器，提供广泛的 Google Workspace 覆盖范围，支持安全默认写入操作、Markdown 到 Google Docs 的转换以及 Drive 同步工作流。

  • by Skeptomenos
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Skeptomenos/google-workspace-mcp-advanced

使用说明

谷歌工作区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 --version

2.从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 stdio

3.添加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.首次运行时进行身份验证

  1. 从MCP客户端启动服务器。
  2. 运行任何谷歌工具（例如，列出日历或列出驱动器文件）。
  3. 在 stdio 模式（默认），完成设备流程：
    • 打开验证URL，
    • 输入用户代码，
    • 请重试工具调用。
    • 如果您的OAuth客户端类型不支持设备流，服务器将自动回退到回调流。
  4. 在 streamable-http，通过打开服务器显示的OAuth URL来完成回调身份验证。
    • 对于MCP托管/手动完成工作流，请使用 complete_google_auth 使用浏览器回调URL。
  5. 凭据保存在 ~/.config/google-workspace-mcp-advanced/credentials/.
  6. 旧目录 ~/.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，请遵循：

文档

贡献者文档位于 AGENTS.md 和 agent-docs/.

相关 MCP