MCP Tools Reference: gmailmcp.googleapis.com

ツール: create_label

認証済みユーザーの Gmail アカウントに新しいラベルを作成します。

次のサンプルは、curl を使用して create_label MCP ツールを呼び出す方法を示しています。

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

入力スキーマ

CreateLabel RPC に対するリクエスト メッセージです。

CreateLabelRequest

JSON 表現 
{
  "displayName": string,

  "color": {
    object (LabelColor)
  }
}
フィールド
displayName

string

必須。作成するラベルの表示名。

共用体フィールド _color。

_color は次のいずれかになります。
color

object (LabelColor)

省略可。ラベルの色。

LabelColor

JSON 表現 
{
  "textColor": string,
  "backgroundColor": string
}
フィールド
textColor

string

ラベルのテキストの色（16 進文字列で表されます。例:「#000000」）。
backgroundColor

string

ラベルの背景色（16 進文字列で表されます。例:「#ffffff」）。

出力スキーマ

ラベルの詳細。

ラベル

JSON 表現 
{
  "labelId": string,
  "name": string,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
フィールド
labelId

string

ラベルの一意の識別子。
name

string

ラベルの表示名（人が読める形式）。
color

object (LabelColor)

省略可。ラベルの色。

共用体フィールド _threads_total。

_threads_total は次のいずれかになります。
threadsTotal

integer

ラベルの下にあるスレッドの合計数。

共用体フィールド _threads_unread。

_threads_unread は次のいずれかになります。
threadsUnread

integer

ラベルの下にある未読のスレッドの数。

LabelColor

JSON 表現 
{
  "textColor": string,
  "backgroundColor": string
}
フィールド
textColor

string

ラベルのテキストの色（16 進文字列で表されます。例:「#000000」）。
backgroundColor

string

ラベルの背景色（16 進文字列で表されます。例:「#ffffff」）。

ツールのアノテーション

破壊的ヒント: ❌ | べき等ヒント: ❌ | 読み取り専用ヒント: ❌ | オープン ワールド ヒント: ❌