Google Workspace MCP

Google Workspace MCP 是一个集成所有主要 Google Workspace 服务的多客户端协议服务器，支持通过自然语言控制 Google Calendar、Drive、Gmail、Docs、Sheets、Slides、Forms、Tasks 和 Chat 等服务。该工具提供高级 OAuth 2.0 认证机制、服务缓存、线程安全会话和多种传输模式（如 Stdio、HTTP 和 SSE），适用于需要自动化办公流程的个人和企业用户。

核心功能

Google Workspace MCP 提供了对 Google Workspace 套件的全面管理功能，包括日历事件管理、文件管理、邮件管理、文档管理、电子表格管理、演示文稿管理、表单管理、任务管理、聊天管理等。其核心功能包括：

• 高级 OAuth 2.0 认证：提供安全的认证机制，支持自动令牌刷新和会话管理。
• 全面的日历管理：支持事件的创建、修改和删除操作。
• 文件管理：支持 Google Drive 上的文件搜索、读取和创建。
• 邮件管理：支持 Gmail 的搜索、发送和草稿创建功能。
• 文档管理：支持 Google Docs 的内容提取、创建和评论管理。
• 电子表格管理：支持 Google Sheets 的单元格操作和评论管理。
• 演示文稿管理：支持 Google Slides 的幻灯片创建和内容管理。
• 表单管理：支持 Google Forms 的创建、检索和响应管理。
• 任务管理：支持 Google Tasks 的任务列表管理和任务状态跟踪。
• 聊天管理：支持 Google Chat 的空间管理和消息发送。
• 高性能：采用 FastMCP 架构，支持服务缓存和线程安全会话。
• 开发者友好：提供最小化代码和自动服务注入功能。

安装方法

Google Workspace MCP 支持多种安装方式，包括一键安装到 Claude 桌面端、命令行快速启动和开发者自定义部署。

推荐使用 uvx 工具进行快速安装，无需手动安装依赖。以下是安装步骤：

uvx workspace-mcp

如果需要配置 Google OAuth 凭证，可以通过环境变量设置：

export GOOGLE_OAUTH_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"

开发者也可以从 GitHub 克隆源码进行本地开发：

git clone https://github.com/taylorwilsdon/google_workspace_mcp.git
cd google_workspace_mcp
uv run main.py

使用方法

Google Workspace MCP 可以通过多种方式使用，包括命令行启动、Claude Desktop 集成和 HTTP 模式调试。

以下是一些常见的使用示例：

uvx workspace-mcp --tools gmail drive calendar

该命令将启动包含 Gmail、Drive 和 Calendar 工具的服务器。

如果需要以 HTTP 模式启动服务器，可以使用以下命令：

uvx workspace-mcp --transport streamable-http

此外，还可以通过指定工具来启动服务器：

uvx workspace-mcp --tools sheets docs

开发者也可以通过 Docker 部署：

docker build -t workspace-mcp .
docker run -p 8000:8000 -v $(pwd):/app workspace-mcp --transport streamable-http

使用示例

Google Workspace MCP 支持通过自然语言指令控制 Google Workspace 服务，以下是几个典型使用场景：

• 创建日历事件：通过自然语言指令创建新的日历事件。
• 发送电子邮件：通过自然语言指令发送电子邮件。
• 管理任务列表：通过自然语言指令管理任务列表。

以下是具体的使用示例：

uvx workspace-mcp --tools calendar

然后通过自然语言指令创建事件：

创建一个名为'团队会议'的事件，时间是明天下午3点。

服务器将自动处理 OAuth 认证，并返回事件创建结果。

配置说明

Google Workspace MCP 需要配置 Google OAuth 凭证，以便与 Google Workspace 服务进行交互。以下是配置步骤：

1. 在 Google Cloud Console 中创建 OAuth 2.0 客户端 ID 和密钥。
2. 启用 Google Calendar、Drive、Gmail、Docs、Sheets、Slides、Forms、Tasks 和 Chat 等 API。
3. 添加重定向 URI：http://localhost:8000/oauth2callback。
4. 设置环境变量：

export GOOGLE_OAUTH_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"

此外，还可以设置其他环境变量以自定义服务器配置：

export OAUTHLIB_INSECURE_TRANSPORT=1
export USER_GOOGLE_EMAIL=your.email@gmail.com

连接到 Claude Desktop

Google Workspace MCP 可以一键集成到 Claude Desktop，用户可以通过 AI 助手访问 Google Workspace 服务。

以下是连接步骤：

1. 下载并安装 google_workspace_mcp.dxt 文件。
2. 在 Claude Desktop 中，依次点击 Settings → Extensions → Google Workspace MCP，粘贴 Google OAuth 凭证。
3. 重启 Claude Desktop，即可开始使用。

如果需要手动配置，可以编辑 claude_desktop_config.json 文件，添加服务器配置：

{
  "mcpServers": {
    "google_workspace": {
      "command": "uvx",
      "args": ["workspace-mcp"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_OAUTH_CLIENT_SECRET": "your-client-secret",
        "OAUTHLIB_INSECURE_TRANSPORT": "1"
      }
    }
  }
}

使用场景

Google Workspace MCP 适用于需要通过自然语言控制 Google Workspace 服务的个人用户和企业用户，特别适合需要自动化办公流程、提高工作效率的场景。

以下是几个典型使用场景：

• 自动化办公流程：通过自然语言指令自动创建日历事件、发送邮件、管理任务等。
• AI 助手集成：与 Claude Desktop 等 AI 助手集成，实现语音或文本控制办公套件。
• 开发者工具：为开发者提供快速部署和调试 Google Workspace 服务的工具。

注意事项

在使用 Google Workspace MCP 时，需要注意以下事项：

• 需要 Google Cloud 项目和 OAuth 2.0 凭证。
• 某些高级功能可能需要额外配置。
• 对于不熟悉命令行的用户可能需要一些学习曲线。

Google Workspace MCP 提供了丰富的功能和灵活的配置选项，能够帮助用户高效管理 Google Workspace 服务，提升办公自动化水平。