关键词

Google WorkspaceGmailCalendarDrive自动化

使用说明

项目简介

Google Workspace MCP Server 是一个应用后端，它实现了 Model Context Protocol (MCP)，旨在为 LLM 客户端提供访问和管理用户 Google Workspace（如 Gmail、日历、云盘）的标准化接口。通过此服务器，LLM 应用可以安全地与用户的 Google Workspace 数据进行交互，实现邮件收发、日程管理、文件操作等功能。

主要功能点

  • 账号管理: 支持添加、认证和移除 Google Workspace 账号。
  • Gmail 操作: 支持邮件搜索、发送邮件、管理草稿、标签和过滤器。
  • 日历操作: 支持事件的列表、创建、更新和删除，以及对事件的回应。
  • 云盘操作: 支持文件的列表、搜索、上传、下载、创建文件夹和权限管理。
  • 附件管理: 支持 Gmail 和日历附件的下载、上传和删除。

安装步骤

  1. 创建 Google Cloud 项目: 访问 Google Cloud Console，创建一个新项目。启用 Gmail API、Calendar API 和 Drive API。配置 OAuth 同意屏幕为外部，添加测试用户，并添加 Gmail、Calendar 和 Drive 所需的 Scope。创建 OAuth 桌面客户端 ID 和密钥。
  2. 配置 MCP 客户端: 例如 Cline，在 Cline 的 MCP 设置 ('cline_mcp_settings.json') 中添加服务器配置信息。配置信息示例如下。
  3. 重启 MCP 客户端: 重启 Cline 或 Claude 等 MCP 客户端。
  4. 连接 Google 账号: 在 MCP 客户端中，通过对话方式请求 AI 助手添加 Google 账号，并按照提示完成身份验证过程。

服务器配置 (用于 MCP 客户端，例如 Cline)

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "docker", // 启动命令，使用 Docker
      "args": [ // 命令参数
        "run",
        "--rm", // 容器退出后自动删除
        "-i", // 保持 STDIN 开放
        "-v", "/path/to/config:/app/config", // 挂载配置文件目录，请替换为实际路径
        "-v", "/path/to/workspace:/app/workspace", // 挂载工作区目录，请替换为实际路径
        "-e", "GOOGLE_CLIENT_ID", // 环境变量：Google 客户端 ID
        "-e", "GOOGLE_CLIENT_SECRET", // 环境变量：Google 客户端密钥
        "-e", "LOG_MODE=strict", // 环境变量：日志模式，推荐 strict 模式
        "ghcr.io/aaronsb/google-workspace-mcp:latest" // Docker 镜像名称
      ],
      "env": { // 环境变量 (可选，也可以直接在 args 中配置)
        "GOOGLE_CLIENT_ID": "YOUR_CLIENT_ID", // 请替换为您的 Google 客户端 ID
        "GOOGLE_CLIENT_SECRET": "YOUR_CLIENT_SECRET" // 请替换为您的 Google 客户端密钥
      },
      "autoApprove": [],
      "disabled": false
    }
  }
}

注意:

  • 请将 '/path/to/config' 替换为本地配置文件目录的实际路径。
  • 请将 '/path/to/workspace' 替换为本地工作区目录的实际路径。
  • 请将 'YOUR_CLIENT_ID' 和 'YOUR_CLIENT_SECRET' 替换为您在 Google Cloud Console 中创建的 OAuth 客户端 ID 和密钥。

基本使用方法

  1. 确保 MCP 服务器已成功启动并运行。
  2. 在 MCP 客户端（如 Cline）中配置并连接到 'google-workspace-mcp' 服务器。
  3. 通过 MCP 客户端的界面或指令，调用服务器提供的工具，例如：
    • 请求 AI 助手列出您的 Gmail 账号：'list_workspace_accounts'
    • 请求 AI 助手搜索邮件：'search_workspace_emails'
    • 请求 AI 助手创建日历事件：'create_workspace_calendar_event'
    • ...更多工具请参考工具列表。

信息

分类

生产力应用

访问项目