MCP Tools Reference: gmailmcp.googleapis.com

Tool: label_thread

Fügt einem gesamten E-Mail-Thread im Gmail-Konto des authentifizierten Nutzers Labels hinzu. Diese Aktion betrifft alle Nachrichten, die sich derzeit im Thread befinden, und alle zukünftigen Nachrichten, die ihm hinzugefügt werden.

Wenn Sie sich nicht sicher sind, welche Thread-ID Sie verwenden müssen, verwenden Sie zuerst das Tool search_threads.

Wenn Sie sich nicht sicher sind, welche ID ein Nutzerlabel hat, verwenden Sie zuerst das Tool list_labels, um die verfügbaren Labels und ihre IDs zu ermitteln.

Im folgenden Beispiel wird gezeigt, wie Sie curl verwenden, um das MCP-Tool label_thread aufzurufen.

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

Eingabeschema

Anfragenachricht für den LabelThread-RPC.

LabelThreadRequest

JSON-Darstellung 
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
Felder
threadId

string

Erforderlich. Die eindeutige Kennung des Threads, dem Labels hinzugefügt werden sollen.
labelIds[]

string

Erforderlich. Die eindeutigen Kennungen der Labels, die hinzugefügt werden sollen. Kann eine Systemlabel-ID sein (z.B. „INBOX“, „TRASH“, „SPAM“, „STARRED“, „UNREAD“, „IMPORTANT“) oder eine vom Nutzer definierte Label-ID. Das Tool akzeptiert label_ids und keine Labelnamen. Verwenden Sie das Tool list_labels, um die entsprechende Label-ID für einen Anzeigenamen für vom Nutzer definierte Labels zu erhalten.

Ausgabeschema

Antwortnachricht für den LabelThread-RPC.

Toolanmerkungen

Destruktiv: ❌ | Idempotent: ✅ | Schreibgeschützt: ❌ | Offene Welt: ❌