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 il 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".

I seguenti esempi mostrano come utilizzare curl per richiamare lo strumento MCP list_labels.

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

Schema di input

Messaggio di richiesta per l'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 l'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 di risultati nell'elenco.

Label

Rappresentazione JSON 
{
  "labelId": string,
  "name": string,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
Campi
labelId

string

L'identificatore univoco dell'etichetta.
name

string

Il nome visualizzato leggibile dell'etichetta.
color

object (LabelColor)

Facoltativo. Il colore dell'etichetta.

Campo unione _threads_total.

_threads_total può essere solo uno dei seguenti tipi:
threadsTotal

integer

Il numero totale di thread sotto l'etichetta.

Campo unione _threads_unread.

_threads_unread può essere solo uno dei seguenti tipi:
threadsUnread

integer

Il numero di thread da leggere sotto l'etichetta.

LabelColor

Rappresentazione JSON 
{
  "textColor": string,
  "backgroundColor": string
}
Campi
textColor

string

Il colore del testo dell'etichetta, rappresentato come una stringa esadecimale (ad es. "#000000").
backgroundColor

string

Il colore di sfondo dell'etichetta, rappresentato come una stringa esadecimale (ad es. "#ffffff").

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento Open World: ❌