MCP Tools Reference: gmailmcp.googleapis.com

Narzędzie: unlabel_message

Usuwa co najmniej 1 etykietę z konkretnej wiadomości na koncie Gmail uwierzytelnionego użytkownika. Aby znaleźć identyfikator wiadomości, użyj narzędzi takich jak search_threads lub get_thread. 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.

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie unlabel_message 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": "unlabel_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat danych wejściowych

Komunikat żądania dla RPC UnlabelMessage.

UnlabelMessageRequest

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

string

Wymagane. Identyfikator wiadomości, z której chcesz usunąć etykiety.
labelIds[]

string

Wymagane. 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 wartości 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ść odpowiedzi dla RPC UnlabelMessage.

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