MCP Tools Reference: gmailmcp.googleapis.com

Strumento: list_labels

Elenca tutte le etichette definite dall'utente disponibili nell'account Gmail dell'utente autenticato. Utilizza questo strumento per scoprire l'id di un'etichetta utente prima di chiamare label_thread, unlabel_thread, label_message o unlabel_message. Le etichette di sistema non vengono restituite da questo strumento, ma possono essere utilizzate con i relativi ID noti: "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT".

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP list_labels.

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

Schema di input

Messaggio di richiesta per la RPC ListLabels.

ListLabelsRequest

Rappresentazione JSON 
{

  "pageSize": integer

  "pageToken": string
}
Campi

Campo unione _page_size.

_page_size può essere solo uno dei seguenti tipi:
pageSize

integer

Facoltativo. Il numero massimo di etichette da restituire.

Campo unione _page_token.

_page_token può essere solo uno dei seguenti tipi:
pageToken

string

Facoltativo. Token di pagina per recuperare una pagina specifica di risultati nell'elenco.

Schema di output

Messaggio di risposta per la RPC ListLabels.

ListLabelsResponse

Rappresentazione JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Campi
labels[]

object (Label)

Elenco delle etichette utente nell'account dell'utente.
nextPageToken

string

Token per recuperare la pagina successiva dei risultati nell'elenco.

Etichetta

Rappresentazione JSON 
{
  "labelId": string,
  "name": string
}
Campi
labelId

string

L'identificatore univoco dell'etichetta.
name

string

Il nome visualizzato dell'etichetta leggibile.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌