MCP Tools Reference: chatmcp.googleapis.com

Tool: send_message

Sendet eine Google Chat-Nachricht an eine Unterhaltung.

Für dieses Tool werden eine Unterhaltungs-ID, eine optionale Thread-ID und ein Nachrichtentext als Eingaben verwendet. Unterhaltungs-IDs lassen sich mit dem Tool „search_conversations“ finden. Sie gibt die erstellte Nachricht zurück.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool send_message aufrufen.

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

Eingabeschema

Anfrage zum Senden einer Nachricht an eine Google Chat-Unterhaltung.

SendMessageRequest

JSON-Darstellung 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Felder
conversationId

string

Erforderlich. Die ID der Unterhaltung (z.B. „spaces/AAAA...“), an die die Nachricht gesendet werden soll.
threadId

string

Optional. Die ID des Threads (z.B. „spaces/AAAA.../threads/BBBB...“), an den die Nachricht gesendet werden soll. Wenn nicht festgelegt, wird die Nachricht in einem neuen Thread gesendet.
messageText

string

Erforderlich. Der Hauptinhalt der Nachricht. Mit einer Teilmenge von Markdown können Sie grundlegende Formatierungen hinzufügen. Informationen zum Formatieren von Nachrichten finden Sie unter Nachrichten formatieren. Die folgenden Formatierungen werden unterstützt:

  • Fett:*text*
  • Kursiv:_text_
  • Durchgestrichen:~text~
  • Monospace:text
  • Monospace-Block:
```
line 1
line 2
```
  • Aufzählungsliste:
* item 1
* item 2
  • Codeblock-Zitat:> quoted text
  • Hyperlink:<url|display text>
  • Nutzer erwähnen:<users/{user_id}>

Ausgabeschema

Antwort auf das Senden einer Nachricht an eine Google Chat-Unterhaltung.

SendMessageResponse

JSON-Darstellung 
{
  "message": {
    object (ChatMessage)
  }
}
Felder
message

object (ChatMessage)

Die gesendete Nachricht.

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 in einem Thread enthalten ist. Format: spaces/{space}/threads/{thread}
plaintextBody

string

Nur-Text-Textkörper der Nachricht.
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 Zusammenfassung der Emoji-Reaktionen in der Nachricht.

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

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ❌ | Hinweis „Offene Welt“: ✅