MCP Tools Reference: gmailmcp.googleapis.com

Tool: label_thread

Fügt einem gesamten 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 sollen, 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. Wenn Sie einem Thread ein Label für den Papierkorb oder Spam hinzufügen möchten, verwenden Sie stattdessen das Tool apply_sensitive_thread_label.

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 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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 LabelThread RPC.

LabelThreadRequest

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

string

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

string

Erforderlich. Die eindeutigen IDs der Labels, die hinzugefügt werden sollen. Kann eine Systemlabel-ID (z.B. „INBOX“, „STARRED“, „UNREAD“, „IMPORTANT“) oder eine nutzerdefinierte Label-ID sein. 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 nutzerdefinierte Labels zu erhalten.

Ausgabeschema

Antwortnachricht für LabelThread RPC.

Toolanmerkungen

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

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify