Google Workspace MCP

一个用于 Google Workspace 的模型上下文协议 (MCP) 服务器，它提供了通过 Admin SDK 管理 Google Workspace 资源的工具。

前提条件

1. 启用了 Admin SDK API 的 Google Cloud Platform 项目
2. 具有适当权限的服务帐户
3. 要模拟的 Google Workspace 管理员用户

设置

服务帐户配置

1. 在 Google Cloud Console 中创建一个服务帐户
2. 授予服务帐户对 Google Workspace Admin SDK 的适当权限
3. 为服务帐户创建并下载 JSON 密钥文件
4. 为服务帐户启用网域范围的授权
5. 在您的 Google Workspace 管理控制台中，向服务帐户授予必要的 OAuth 范围

环境变量

应用程序需要设置以下环境变量：

变量	描述
GOOGLE_SERVICE_ACCOUNT	服务帐户 JSON 密钥文件的路径
GOOGLE_ADMIN_EMAIL	要模拟的 Google Workspace 管理员用户的电子邮件地址

用法

构建

make build

配置

 {
  "mcpServers": {
     "googleworkspace-mcp": {
      "command": "/go/bin/google-workspace-mcp",
      "args": [],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT": "test.json",
        "GOOGLE_ADMIN_EMAIL": "admin@yourdomain.com"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

注意： 确保您的服务帐户已在 Google Cloud Console 中启用必要的 API 访问权限（Admin SDK API、Gmail API 和 Calendar API）。

可用工具

• directory_users - 列出您的 Google Workspace 目录中的所有用户
• create_user - 在 Google Workspace 中创建一个新用户
• list_gmail - 列出最近的 Gmail 消息（需要 Gmail API 访问权限）
• list_calendar_events - 列出用户的即将到来的日历事件（需要 Calendar API 访问权限）
• create_calendar_event - 创建一个新的日历事件（需要 Calendar API 访问权限）

必需的 OAuth 范围

在为您的服务帐户设置网域范围的授权时，请确保授予以下 OAuth 范围：

• https://www.googleapis.com/auth/admin.directory.user - 用于访问和管理目录用户信息
• https://www.googleapis.com/auth/gmail.readonly - 用于读取 Gmail 消息
• https://www.googleapis.com/auth/calendar - 用于读取和写入日历事件