MCP Tools Reference: gmailmcp.googleapis.com

Ferramenta: create_label

Cria um novo marcador na conta do Gmail do usuário autenticado.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta create_label MCP.

Solicitação 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

Mensagem de solicitação para a RPC CreateLabel.

CreateLabelRequest

Representação JSON
{
  "displayName": string,

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

string

Obrigatório. O nome de exibição do rótulo a ser criado.

Campo de união _color.

_color pode ser apenas de um dos tipos a seguir:

color

object (LabelColor)

Opcional. É a cor do rótulo.

LabelColor

Representação JSON
{
  "textColor": string,
  "backgroundColor": string
}
Campos
textColor

string

A cor do texto do rótulo, representada como uma string hexadecimal (por exemplo, "#000000").

backgroundColor

string

A cor de fundo do marcador, representada como uma string hexadecimal (por exemplo, "#ffffff").

Esquema de saída

Detalhes de um rótulo.

Rótulo

Representação JSON
{
  "labelId": string,
  "name": string,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
Campos
labelId

string

O identificador exclusivo do rótulo.

name

string

O nome de exibição legível do rótulo.

color

object (LabelColor)

Opcional. É a cor do rótulo.

Campo de união _threads_total.

_threads_total pode ser apenas de um dos tipos a seguir:

threadsTotal

integer

O número total de conversas no marcador.

Campo de união _threads_unread.

_threads_unread pode ser apenas de um dos tipos a seguir:

threadsUnread

integer

O número de conversas não lidas no marcador.

LabelColor

Representação JSON
{
  "textColor": string,
  "backgroundColor": string
}
Campos
textColor

string

A cor do texto do rótulo, representada como uma string hexadecimal (por exemplo, "#000000").

backgroundColor

string

A cor de fundo do marcador, representada como uma string hexadecimal (por exemplo, "#ffffff").

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌