MCP Tools Reference: gmailmcp.googleapis.com

ツール: list_labels

認証されたユーザーの Gmail アカウントで使用できるユーザー定義ラベルをすべて一覧表示します。このツールを使用して、ユーザーラベルの id を確認します。label_thread、unlabel_thread、label_message、unlabel_message を呼び出す前に。このツールではシステム ラベルは返されませんが、既知の ID（'INBOX'、'TRASH'、'SPAM'、'STARRED'、'UNREAD'、'IMPORTANT'、'CHAT'、'DRAFT'、'SENT'）で使用できます。

次のサンプルは、curl を使用して list_labels 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": "list_labels",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

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

ListLabelsRequest

JSON 表現 
{

  "pageSize": integer

  "pageToken": string
}
フィールド

共用体フィールド _page_size。

_page_size は次のいずれかになります。
pageSize

integer

省略可。返されるラベルの最大数。

共用体フィールド _page_token。

_page_token は次のいずれかになります。
pageToken

string

省略可。リスト内の特定の結果ページを取得するためのページトークン。

出力スキーマ

ListLabels RPC に対するレスポンス メッセージ。

ListLabelsResponse

JSON 表現 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
フィールド
labels[]

object (Label)

ユーザーのアカウント内のユーザーラベルのリスト。
nextPageToken

string

リスト内の次のページの結果を取得するためのトークン。

ラベル

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）で表されます）。

ツールのアノテーション

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