Google Workspace MCP Server

关键词

GmailGoogle WorkspaceOAuthAPI 集成自动化

使用说明（Markdown格式）

  • 项目简介

    • 该仓库实现了一个基于 MCP 的服务器端，用于向 MCP 客户端提供对 Google Workspace 服务的资源访问、工具调用以及提示模板渲染等能力。服务器核心采用 FastMCP 框架，工具函数通过装饰器注册到 MCP 服务中，并通过 OAuth2 进行 Google 服务认证。

  • 主要功能点

    • Native MCP 协议实现：通过 JSON-RPC 与客户端通信，提供资源、工具、提示模板的读取与执行能力。
    • 资源、工具和提示模板管理：托管并暴露对 Gmail、日历、Drive、Docs、Sheets、Contacts 等 Google Workspace 服务的工具集与数据。
    • 认证与会话管理：内置 Google OAuth 认证管理，支持自动刷新、令牌保存与状态查询。
    • 异步高性能：基于 async/await 架构，适合高并发调用场景。
    • 安全与可扩展：提供结构化日志、错误处理（包括标准化错误码）、以及 Atlas 适配能力等扩展点。
    • 多传输协议支持：设计上可扩展以支持 Stdio、SSE、WebSocket 等传输方式，便于与不同客户端集成。

  • 安装步骤

    1. 克隆仓库并进入目录
    2. 使用 Poetry 安装依赖（推荐）
      • poetry install
    3. 设置 Google OAuth 凭据
      • 参考 .env.example，填入 Google Client ID、Client Secret、Redirect URI 等信息，必要时提供 credentials.json 路径。
    4. 启动服务器
      • 运行方式示例：poetry run python -m google_workspace_mcp
      • 服务会按配置初始化并注册工具集（gmail、calendar、drive、docs、sheets、contacts 等）。
    5. 验证启动
      • 通过测试脚本或 MCP 客户端对服务器进行工具调用与资源读取，确保授权就绪即可使用。

  • 服务器配置（MCP 客户端启动需要的最小信息） 说明：MCP 客户端需要的仅是服务器启动命令及参数信息来建立连接。以下 JSON 示例为配置模板，实际使用时请替换注释中的占位信息。 { "server_name": "google-workspace", "command": "poetry", "args": ["run", "python", "-m", "google_workspace_mcp"], "notes": "启动 Google Workspace MCP Server 的命令和参数。客户端无需此配置，但用于客户端连接前的服务器端启动准备。" }

  • 基本使用方法

    • 启动后，MCP 客户端可以通过标准的 JSON-RPC 调用来:
      • 读取资源（如 Gmail、日历、Drive 等相关数据）
      • 调用工具（gmail_send、calendar_event_create、drive_upload 等）
      • 获取并渲染 Prompts/模板（Markdown 转 Docs 请求等）
    • 日常场景包括用拉取数据、执行跨服务的工作流、以及与 Claude 等 MCP 客户端协同创建对话上下文。

  • 注意事项

    • 请确保 Google OAuth 授权作用域完整且令牌有效，否则某些工具将返回错误。
    • 部署环境需要网络连通性良好以访问 Google API。
    • 如需 Atlas/扩展适配，请参考 atlas_manifest 等扩展组件。

  • 关键词 Gmail, Google Workspace, OAuth, API 集成, 自动化

  • 分类 3

服务器信息

访问项目