MCP Tools Reference: chatmcp.googleapis.com

ツール: search_messages

キーワードとフィルタを使用して Google Chat メッセージを検索し、Markdown 形式で返します。ユーザーがアクセスできるすべてのスペースで機能します。特定の会話にスコープを設定することもできます。

search_messages を使用するか、他の検索ツールや読み取りツールを使用するかを判断する際は、次のガイダンスに従ってください。

• 複数のスペースにまたがる可能性のある特定のメッセージ コンテンツ、キーワード、メンション、リンク、送信者、未読のメッセージを検索する場合や、既知の会話 ID がない場合は、search_messages を使用します。
• 特定のスペースまたはスレッドの ID がわかっていて、メッセージを時系列順に順番に読み取る場合は、list_messages を使用します。
• search_conversations を使用して、スペースの表示名や参加者で会話 ID などのスペースのメタデータを検索します（メッセージの内容ではなく、メタデータのみを検索します）。

特定のフィルタなしで searchParameters が指定されている場合、ユーザーがアクセスできる会話の最近のメッセージが返されます。

次のコードサンプルは、curl を使用して search_messages MCP ツールを呼び出す方法を示しています。

入力スキーマ

{
  "searchParameters": {
    object (SearchParameters)
  },
  "pageSize": integer,
  "pageToken": string
}

{
  "keywords": [
    string
  ],
  "conversationId": string,
  "sender": string,
  "isUnread": boolean,
  "hasLink": boolean,
  "startTime": string,
  "endTime": string,
  "mentionsMe": boolean,
  "conversationIncludesUser": string,
  "spaceDisplayNames": [
    string
  ]
}

出力スキーマ

{
  "messages": [
    {
      object (ChatMessage)
    }
  ],
  "nextPageToken": string
}

{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}

{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}

{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}

{
  "emoji": string,
  "count": integer
}

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントはこれらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値のヒントが次のように定義されています。

• readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
• destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
• idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に影響はありません。デフォルトは false です。
• openWorldHint: true の場合、ツールは外部エンティティの「オープン ワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌

認可スコープ

次の OAuth スコープのいずれかが必要です。

• https://www.googleapis.com/auth/chat.messages.readonly
• https://www.googleapis.com/auth/chat.spaces.readonly
• https://www.googleapis.com/auth/chat.memberships.readonly
• https://www.googleapis.com/auth/chat.users.readstate.readonly