Google Chat MCP

谷歌聊天MCP服务器

是利用谷歌Chat API的MCP（Model Context Protocol）服务器。 可以收发消息，获取空间成员信息。

机能

空间关系

• list_spaces -获取参与空间列表
• get_space -获取空间详细信息

成员关系

• list_members -获取空间中的成员列表

消息关系

• list_messages -获取空间中的消息列表
• get_message -获取消息详细信息
• create_message -发送消息
• update_message -更新消息
• delete_message -删除消息

安装，安装

1.设置谷歌Cloud Project

1. 谷歌云控制台 访问
2. 创建新项目（或选择现有项目）
3. “API和服务”→“库” 谷歌聊天API 启用

2.OAuth同意画面的设定

1. “API和服务”→“OAuth同意画面”
2. 选择用户类型（内部或外部）
3. 输入应用程序名称、用户支持邮件、开发商联系人
4. 添加范围：

- https://www.googleapis.com/auth/chat.spaces.readonly - https://www.googleapis.com/auth/chat.memberships.readonly - https://www.googleapis.com/auth/chat.messages

3.OAuth客户端ID的创建

1. API和服务-凭据
2. “创建凭据”→“OAuth客户机标识”
3. 应用程序类型： 网络应用程序
4. 输入名称
5. 已批准的重定向URI: http://localhost:8080/callback 添加
6. 创建-下载JSON

4.Chat App的设置（必需）

1. “API和服务”→“有效的API和服务”→“谷歌Chat API”
2. 打开配置选项卡
3. 设置：

- 应用程序名称：任意名称 - 头像URL：任何图像URL（必需） - 说明: 任意 - 接続设定：选择“HTTP端点URL”https://example.com 输入（实际不使用） - 公开设定：选择内部或特定用户

1. 单击保存

5.信贷配置

mkdir -p credentials
# ダウンロードした JSON を配置
mv ~/Downloads/client_secret_*.json credentials/client_secret.json

6.安装和构建依赖关系

pnpm install
pnpm run build

使用方法

MCP设定

.mcp.json 将添加到项目根目录或Claude Code设置中：

{
  "mcpServers": {
    "google-chat": {
      "command": "node",
      "args": ["/path/to/google-chat-mcp/dist/index.js"],
      "env": {
        "CLIENT_SECRET_PATH": "/path/to/google-chat-mcp/credentials/client_secret.json",
        "TOKEN_PATH": "/path/to/google-chat-mcp/credentials/token.json"
      }
    }
  }
}

初回认证

首次启动时浏览器打开，要求用谷歌账户进行认证。 认证完成后，标记 credentials/token.json 中所述修改相应参数的值。

使用工具

获取空间列表

list_spaces

发送消息

create_message
  spaceName: "spaces/AAAA"
  text: "こんにちは！"

获取消息列表

list_messages
  spaceName: "spaces/AAAA"
  pageSize: 10

制限事项

• 无法获取直接消息（DM） -根据Google Chat API的规格，人类之间的DM不能通过API取得
• 因为使用了OAuth2认证，所以只能操作个人谷歌账户可以访问的空间
• 注意Chat API的配额限制
• 标记过期时自动刷新

许可证

麻省理工学院