MCP Tools Reference: gmailmcp.googleapis.com

Herramienta: create_label

Crea una etiqueta nueva en la cuenta de Gmail del usuario autenticado.

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

Solicitud de 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": "create_label",
    "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 CreateLabel.

CreateLabelRequest

Representación JSON 
{
  "displayName": string,

  "color": {
    object (LabelColor)
  }
}
Campos
displayName

string

Obligatorio. Es el nombre visible de la etiqueta que se creará.

Campo de unión _color.

_color puede ser una de las siguientes opciones:
color

object (LabelColor)

Opcional. Es el color de 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").
backgroundColor

string

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

Esquema de salida

Son los detalles de una etiqueta.

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 conversaciones bajo 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").
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: ❌