MCP Tools Reference: chatmcp.googleapis.com

工具：update_notification_settings

更新特定对话（Google Chat 聊天室、群聊或私信）的聊天室通知偏好设置和/或静音状态，以管理对话干扰并保护专注时间。

前提条件：

  • conversationId 为必填项（格式：spaces/{space}）。
  • 必须至少提供 notificationSetting 或 muteSetting 之一。

支持的通知频率 (notificationSetting)：

  • ALL：接收所有消息的通知。
  • MAIN_CONVERSATIONS：仅接收主要对话的通知。
  • FOR_YOU：接收有关提及、@所有人以及关注的消息串的通知（1 对 1 私信不支持此选项）。
  • OFF：关闭所有通知。

注意：1 对 1 私信不支持 FOR_YOU。在 1:1 私信中设置 FOR_YOU 无效，会返回 INVALID_ARGUMENT 错误。

支持的静音状态 (muteSetting)：

  • UNMUTED：取消忽略对话。系统会根据notificationSetting发送通知。
  • MUTED：忽略会话。无论 notificationSetting 如何，都会抑制所有通知。

返回更新后的 SpaceNotificationSetting 对象，其中包含 notificationSetting 和 muteSetting。

以下代码示例展示了如何使用 curl 调用 update_notification_settings MCP 工具。

Curl 请求 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_notification_settings",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

UpdateNotificationSettingsRequest

JSON 表示法 
{
  "conversationId": string,
  "notificationSetting": enum (NotificationSetting),
  "muteSetting": enum (MuteSetting)
}
字段
conversationId

string

必需。对话的资源名称，格式为：spaces/{space}。
notificationSetting

enum (NotificationSetting)

可选。聊天室的通知频率偏好设置。
muteSetting

enum (MuteSetting)

可选。聊天室的忽略状态。

NotificationSetting

Google Chat 中的聊天室通知频率选项。

枚举
NOTIFICATION_SETTING_UNSPECIFIED 未指定通知设置。
ALL 用户会收到对话中所有消息的通知。
MAIN_CONVERSATIONS 用户只会收到主要对话的通知。
FOR_YOU 用户会收到提及、@all 和关注的消息串的通知。
OFF 用户不会收到有关对话中消息的通知。

MuteSetting

Google Chat 对话的忽略状态。

枚举
MUTE_SETTING_UNSPECIFIED 未指定忽略设置。
UNMUTED 对话已取消静音。
MUTED 对话已设为静音。

输出架构

Google Chat 中用户的聊天室通知设置，用于指定用户对聊天室的通知频率偏好设置和忽略状态。

SpaceNotificationSetting

JSON 表示法 
{
  "notificationSetting": enum (NotificationSetting),
  "muteSetting": enum (MuteSetting)
}
字段
notificationSetting

enum (NotificationSetting)

可选。聊天室的通知频率偏好设置。
muteSetting

enum (MuteSetting)

可选。聊天室是否已忽略。

NotificationSetting

Google Chat 中的聊天室通知频率选项。

枚举
NOTIFICATION_SETTING_UNSPECIFIED 未指定通知设置。
ALL 用户会收到对话中所有消息的通知。
MAIN_CONVERSATIONS 用户只会收到主要对话的通知。
FOR_YOU 用户会收到提及、@all 和关注的消息串的通知。
OFF 用户不会收到有关对话中消息的通知。

MuteSetting

Google Chat 对话的忽略状态。

枚举
MUTE_SETTING_UNSPECIFIED 未指定忽略设置。
UNMUTED 对话已取消静音。
MUTED 对话已设为静音。

工具注释

工具注解会发送到 MCP 客户端，用于描述给定工具的基本风险。大多数客户端会将这些提示视为不可信，但可用于决定何时向用户发送确认提示。

除了标题字符串之外，还定义了以下布尔值提示：

  • readOnlyHint：如果为 true，则该工具不会修改其环境。默认值：false。
  • destructiveHint：如果为 true，则该工具可以执行破坏性操作。如果为 false，则该工具只能执行添加操作。默认值：true。
  • idempotentHint：如果为 true，则使用相同参数重复调用该工具不会对其环境产生额外影响。默认值：false。
  • openWorldHint：如果为 true，则该工具可以与外部实体的“开放世界”进行交互。如果为 false，则该工具只能与内部实体交互。例如，网页搜索工具是开放世界，而记忆工具不是开放世界。

破坏性提示：❌ | 幂等性提示：✅ | 只读提示：❌ | 开放世界提示：❌

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/chat.users.spacesettings