MCP Tools Reference: gmailmcp.googleapis.com

도구: list_labels

인증된 사용자의 Gmail 계정에서 사용할 수 있는 모든 사용자 정의 라벨을 나열합니다. label_thread, unlabel_thread, label_message, 또는 unlabel_message를 호출하기 전에 이 도구를 사용하여 사용자 라벨의 id를 찾습니다. 시스템 라벨은 이 도구에서 반환되지 않지만 잘 알려진 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

라벨의 사람이 읽을 수 있는 표시 이름입니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 개방형 세계 힌트: ❌