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' \
--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 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
}
フィールド
labelId

string

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

string

ラベルの人間が読める表示名。

ツールのアノテーション

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