MCP Tools Reference: gmailmcp.googleapis.com

Herramienta: list_labels

Enumera todas las etiquetas definidas por el usuario que están disponibles en la cuenta de Gmail del usuario autenticado. Usa esta herramienta para descubrir el id de una etiqueta del usuario antes de llamar a label_thread, unlabel_thread, label_message o unlabel_message. Esta herramienta no devuelve 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 de MCP list_labels.

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

Esquema de entrada

Es el mensaje de solicitud para la RPC de ListLabels.

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

Opcional. Es la cantidad máxima de etiquetas que se devolverán.

Campo de unión _page_token.

_page_token puede ser una de las siguientes opciones:
pageToken

string

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

Esquema de salida

Es el mensaje de respuesta para la RPC de ListLabels.

ListLabelsResponse

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

object (Label)

Es la lista de etiquetas del usuario en su cuenta.
nextPageToken

string

Token para recuperar la siguiente página 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 de la etiqueta legible por humanos.
color

object (LabelColor)

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 subprocesos asociados a 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 del texto de la etiqueta, representado como una cadena hexadecimal (p.ej., "#000000"). Solo se permite el siguiente conjunto predefinido de valores de color: #000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, #fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c, #464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765
backgroundColor

string

Es el color de fondo de la etiqueta, representado como una cadena hexadecimal (p.ej., "#ffffff"). Solo se permite el siguiente conjunto predefinido de valores de color: #000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, #fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c, #464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765

Anotaciones de herramientas

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

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

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