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

標籤的專屬 ID。
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

標籤的文字顏色，以十六進位字串表示 (例如「#000000」)。
backgroundColor

string

標籤的背景顏色，以十六進位字串表示 (例如「#ffffff」)。

工具註解

破壞性提示：❌ | 等冪提示：✅ | 唯讀提示：✅ | 開放世界提示：❌