MCP Tools Reference: gmailmcp.googleapis.com

Tool: create_label

Erstellt ein neues Label im Gmail-Konto des authentifizierten Nutzers.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool create_label aufrufen.

Curl-Anfrage 
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
}'

Eingabeschema

Anfragenachricht für den RPC „CreateLabel“.

CreateLabelRequest

JSON-Darstellung 
{
  "displayName": string,

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

string

Erforderlich. Der Anzeigename des zu erstellenden Labels.

Union-Feld _color.

Für _color ist nur einer der folgenden Werte zulässig:
color

object (LabelColor)

Optional. Die Farbe des Labels.

LabelColor

JSON-Darstellung 
{
  "textColor": string,
  "backgroundColor": string
}
Felder
textColor

string

Die Textfarbe des Labels als Hexadezimalstring (z.B. „#000000“).
backgroundColor

string

Die Hintergrundfarbe des Labels als Hexadezimalstring (z.B. „#ffffff“).

Ausgabeschema

Details eines Labels.

Label

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

  "threadsTotal": integer

  "threadsUnread": integer
}
Felder
labelId

string

Die eindeutige ID des Labels.
name

string

Der für Menschen lesbare Anzeigename des Labels.
color

object (LabelColor)

Optional. Die Farbe des Labels.

Union-Feld _threads_total.

Für _threads_total ist nur einer der folgenden Werte zulässig:
threadsTotal

integer

Die Gesamtzahl der Threads unter dem Label.

Union-Feld _threads_unread.

Für _threads_unread ist nur einer der folgenden Werte zulässig:
threadsUnread

integer

Die Anzahl der ungelesenen Threads unter dem Label.

LabelColor

JSON-Darstellung 
{
  "textColor": string,
  "backgroundColor": string
}
Felder
textColor

string

Die Textfarbe des Labels als Hexadezimalstring (z.B. „#000000“).
backgroundColor

string

Die Hintergrundfarbe des Labels als Hexadezimalstring (z.B. „#ffffff“).

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ❌ | Hinweis „Offene Welt“: ❌