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 wpłynie na wszystkie wiadomości w wątku i wszystkie przyszłe wiadomości, które zostaną do niego dodane.

Jeśli nie masz pewności, jaki jest identyfikator wątku, najpierw użyj narzędzia search_threads.

Jeśli nie masz pewności, jaki jest identyfikator etykiety użytkownika, najpierw użyj narzędzia list_labels, aby sprawdzić dostępne etykiety i ich identyfikatory. Aby dodać do wątku etykietę kosza lub spamu, użyj narzędzia apply_sensitive_thread_label.

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie label_thread MCP.

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

Schemat danych wejściowych

Wiadomość z prośbą o wywołanie RPC LabelThread.

LabelThreadRequest

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

string

Wymagane. Unikalny identyfikator wątku, do którego chcesz dodać etykiety.
labelIds[]

string

Wymagane. Unikalne identyfikatory etykiet do dodania. Może to być identyfikator etykiety systemowej (np. „SKRZYNKA ODBIORCZA”, „OZNACZONE GWIAZDKĄ”, „NIEPRZECZYTANE”, „WAŻNE”) lub identyfikator etykiety zdefiniowanej przez użytkownika. Narzędzie akceptuje label_ids, a nie nazwy etykiet. Użyj narzędzia list_labels, aby uzyskać identyfikator etykiety odpowiadający wyświetlanej nazwie etykiet zdefiniowanych przez użytkownika.

Schemat wyjściowy

Wiadomość z odpowiedzią dla RPC LabelThread.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ❌ | Open World Hint: ❌

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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