MCP Tools Reference: gmailmcp.googleapis.com

Tool: label_thread

Fügt dem gesamten E-Mail-Verlauf im Gmail-Konto des authentifizierten Nutzers Labels hinzu. Dieser Vorgang wirkt sich auf alle Nachrichten aus, die sich derzeit im Thread befinden, und auf alle zukünftigen Nachrichten, die dem Thread hinzugefügt werden.

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

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

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

Curl-Anfrage
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--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 MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

Eingabeschema

Anfragenachricht für den RPC „LabelThread“.

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 hinzuzufügenden Labels. Kann eine Systemlabel-ID (z.B. „INBOX“, „TRASH“, „SPAM“, „STARRED“, „UNREAD“) oder eine benutzerdefinierte Label-ID sein.

Ausgabeschema

Antwortnachricht für den LabelThread-RPC.

Tool-Annotationen

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