MCP Tools Reference: chatmcp.googleapis.com

Tool: list_messages

Ruft Nachrichten aus einer angegebenen Google Chat-Unterhaltung (Gruppenbereich, Direktnachricht (DN) oder Gruppen-DN) im Markdown-Format ab. Ermöglicht das Filtern nach Thread, Zeitraum und Anzahl der Nachrichten. Außerdem kann die nächste Seite mit Nachrichten abgerufen werden, um mehr Kontext zu erhalten. Private Nachrichten (Nachrichten, die nur für einen einzelnen Nutzer sichtbar sind) werden herausgefiltert.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool list_messages aufrufen.

Curl-Anfrage 
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": "list_messages",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

ListChatMessagesRequest

JSON-Darstellung 
{
  "conversationId": string,
  "threadId": string,
  "pageSize": integer,
  "pageToken": string,
  "startTime": string,
  "endTime": string
}
Felder
conversationId

string

Erforderlich. Die ID der Unterhaltung. Eine Unterhaltung kann ein Gruppenbereich, eine Direktnachricht oder ein Gruppenchat sein. Format: spaces/{space}
threadId

string

Optional. Die ID einer bestimmten Unterhaltung in der Unterhaltung. Wenn angegeben, werden nur Nachrichten aus diesem Thread zurückgegeben. Wenn diese Option nicht angegeben wird, werden Nachrichten aus allen Threads in der Unterhaltung berücksichtigt. Format: spaces/{space}/threads/{thread}
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Nachrichten. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nichts anderes angegeben wird, wird der Wert standardmäßig auf 20 gesetzt. Der Höchstwert ist 50. Wenn Sie einen Wert über 50 verwenden, wird er automatisch in 50 geändert.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen list_messages-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.
startTime

string

Optional. ISO 8601-Zeitstempel zum Filtern von Nachrichten. Es werden nur Nachrichten zurückgegeben, die nach diesem Zeitpunkt erstellt wurden.
endTime

string

Optional. ISO 8601-Zeitstempel zum Filtern von Nachrichten. Es werden nur Nachrichten zurückgegeben, die vor diesem Zeitpunkt erstellt wurden.

Ausgabeschema

Antwort mit der Liste der Nachrichten aus der angeforderten Unterhaltung.

ListChatMessagesResponse

JSON-Darstellung 
{
  "messages": [
    {
      object (ChatMessage)
    }
  ],
  "nextPageToken": string
}
Felder
messages[]

object (ChatMessage)

Liste der abgerufenen Nachrichten in umgekehrter chronologischer Reihenfolge (neueste zuerst).
nextPageToken

string

Ein Token, das als page_token in einem nachfolgenden ListMessagesRequest gesendet werden kann, um die nächste Seite mit Nachrichten abzurufen. Wenn dieses Feld leer ist, gibt es keine weiteren Seiten.

ChatMessage

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

string

Ressourcenname der Nachricht. Format: spaces/{space}/messages/{message}
threadId

string

Der Thread, zu dem diese Nachricht gehört. Dieser Parameter ist leer, wenn die Nachricht nicht Teil eines Threads ist. Format: spaces/{space}/threads/{thread}
plaintextBody

string

Textkörper der Nachricht mit Markdown-Formatierung.
sender

object (User)

Der Absender der Nachricht.
createTime

string

Nur Ausgabe. Zeitstempel für die Erstellung der Nachricht.
threadedReply

boolean

Gibt an, ob es sich bei der Nachricht um eine Thread-Antwort handelt.
attachments[]

object (ChatAttachmentMetadata)

In der Nachricht enthaltene Anhänge
reactionSummaries[]

object (ReactionSummary)

Die in der Nachricht enthaltene Zusammenfassung der Emoji-Reaktionen.

Nutzer

JSON-Darstellung 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Felder
userId

string

Ressourcenname eines Chat-Nutzers. Format: users/{user}.
displayName

string

Der Anzeigename eines Chat-Nutzers.
email

string

Die E-Mail-Adresse des Nutzers. Dieses Feld wird nur ausgefüllt, wenn der Nutzertyp „HUMAN“ ist.
userType

enum (UserType)

Der Typ des Nutzers.

ChatAttachmentMetadata

JSON-Darstellung 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Felder
attachmentId

string

Ressourcenname des Anhangs. Format: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Name des Anhangs.
mimeType

string

Inhaltstyp (MIME-Typ).
source

enum (Source)

Die Quelle des Anhangs.

ReactionSummary

JSON-Darstellung 
{
  "emoji": string,
  "count": integer
}
Felder
emoji

string

Der Unicode-String des Emojis oder der Name des benutzerdefinierten Emojis.
count

integer

Die Gesamtzahl der Reaktionen mit dem zugehörigen Emoji.

UserType

Der Typ eines Google Chat-Nutzers.

Enums
USER_TYPE_UNSPECIFIED Nicht angegeben
HUMAN Menschlicher Nutzer.
APP App-Nutzer

Quelle

Die Quelle des Anhangs.

Enums
SOURCE_UNSPECIFIED Reserviert.
DRIVE_FILE Die Datei ist eine Google Drive-Datei.
UPLOADED_CONTENT Die Datei wird in Chat hochgeladen.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet wird.

Zusammen mit dem Titelstring sind die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Einheiten interagieren. Wenn „false“, kann das Tool nur mit internen Einheiten interagieren. Aware-Tools sind beispielsweise frei verfügbar, während Memory-Tools nicht frei verfügbar sind.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly