MCP Tools Reference: gmailmcp.googleapis.com

Narzędzie: label_thread

Dodaje etykiety do całego wątku na koncie Gmail uwierzytelnionego użytkownika. Ta operacja dotyczy wszystkich wiadomości znajdujących się obecnie w wątku oraz wszystkich przyszłych wiadomości dodanych do tego wątku.

Jeśli nie masz pewności co do identyfikatora wątku, najpierw użyj narzędzia search_threads.

Jeśli nie masz pewności co do identyfikatora etykiety użytkownika, najpierw użyj narzędzia list_labels, aby sprawdzić dostępne etykiety i ich identyfikatory.

Poniższy przykład pokazuje, jak użyć narzędzia curl do wywołania narzędzia MCP label_thread.

Żądanie Curl
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
}'
                

Schemat wejściowy

Komunikat żądania RPC LabelThread.

LabelThreadRequest

Zapis JSON
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
Pola
threadId

string

Wymagane. Unikalny identyfikator wątku, do którego mają zostać dodane etykiety.

labelIds[]

string

Wymagane. Unikalne identyfikatory etykiet, które mają zostać dodane. Może to być identyfikator etykiety systemowej (np. „INBOX”, „TRASH”, „SPAM”, „STARRED”, „UNREAD”, „IMPORTANT”) lub identyfikator etykiety zdefiniowanej przez użytkownika. Narzędzie akceptuje label_ids, a nie nazwy etykiet. Aby uzyskać odpowiedni identyfikator etykiety dla nazwy wyświetlanej etykiety zdefiniowanej przez użytkownika, użyj narzędzia list_labels.

Schemat wyjściowy

Komunikat odpowiedzi RPC LabelThread.

Adnotacje narzędzia

Wskazówka dotycząca operacji destrukcyjnych: ❌ | Wskazówka dotycząca idempotentności: ✅ | Wskazówka dotycząca trybu tylko do odczytu: ❌ | Wskazówka dotycząca otwartego świata: ❌