MCP Tools Reference: gmailmcp.googleapis.com

Herramienta: list_labels

Enumera todas las etiquetas definidas por el usuario disponibles en la cuenta de Gmail del usuario autenticado. Usa esta herramienta para descubrir el id de una etiqueta de usuario antes de llamar a label_thread, unlabel_thread, label_message o unlabel_message. Esta herramienta no muestra las etiquetas del sistema, pero se pueden usar con sus IDs conocidos: "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT" y "SENT".

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta MCP list_labels.

Solicitud 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
}'

Esquema de entrada

Mensaje de solicitud para ListLabels RPC.

ListLabelsRequest

Representación JSON 
{

  "pageSize": integer

  "pageToken": string
}
Campos

Campo de unión _page_size.

_page_size puede ser una de las siguientes opciones:
pageSize

integer

Es opcional. Es la cantidad máxima de etiquetas que se mostrarán.

Campo de unión _page_token.

_page_token puede ser una de las siguientes opciones:
pageToken

string

Es opcional. Es el token de página para recuperar una página específica de resultados en la lista.

Esquema de salida

Mensaje de respuesta para ListLabels RPC.

ListLabelsResponse

Representación JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Campos
labels[]

object (Label)

Lista de etiquetas de usuario en la cuenta del usuario.
nextPageToken

string

Token para recuperar la página siguiente de resultados en la lista.

Etiqueta

Representación JSON 
{
  "labelId": string,
  "name": string,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
Campos
labelId

string

Es el identificador único de la etiqueta.
name

string

Es el nombre visible y legible por humanos de la etiqueta.
color

object (LabelColor)

Es opcional. Es el color de la etiqueta.

Campo de unión _threads_total.

_threads_total puede ser una de las siguientes opciones:
threadsTotal

integer

Es la cantidad total de conversaciones en la etiqueta.

Campo de unión _threads_unread.

_threads_unread puede ser una de las siguientes opciones:
threadsUnread

integer

Es la cantidad de conversaciones no leídas en la etiqueta.

LabelColor

Representación JSON 
{
  "textColor": string,
  "backgroundColor": string
}
Campos
textColor

string

Es el color de texto de la etiqueta, representado como una cadena hexadecimal (p.ej., "#000000").
backgroundColor

string

Es el color de fondo de la etiqueta, representado como una cadena hexadecimal (p.ej., "#ffffff").

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌