MCP Tools Reference: gmailmcp.googleapis.com

Narzędzie: unlabel_thread

Usuwa etykiety z całego wątku na koncie Gmail uwierzytelnionego użytkownika. 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.

Poniższy przykład pokazuje, jak użyć curl, aby wywołać narzędzie MCP unlabel_thread.

Żą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": "unlabel_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

Schemat wejściowy

Komunikat żądania dla RPC UnlabelThread.

UnlabelThreadRequest

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

string

Wymagane. Unikalny identyfikator wątku, z którego mają zostać usunięte etykiety.

labelIds[]

string

Wymagane. Unikalne identyfikatory etykiet do usunięcia. 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 dla RPC UnlabelThread.

Adnotacje narzędzia

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

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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