MCP Tools Reference: gmailmcp.googleapis.com

Alat: list_labels

Mencantumkan semua label yang ditentukan pengguna yang tersedia di akun Gmail pengguna terautentikasi. Gunakan alat ini untuk menemukan id label pengguna sebelum memanggil label_thread, unlabel_thread, label_message, atau unlabel_message. Label sistem tidak ditampilkan oleh alat ini, tetapi dapat digunakan dengan ID yang sudah dikenal: 'INBOX', 'TRASH', 'SPAM', 'STARRED', 'UNREAD', 'IMPORTANT', 'CHAT', 'DRAFT', 'SENT'.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP list_labels.

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

Skema Input

Pesan permintaan untuk RPC ListLabels.

ListLabelsRequest

Representasi JSON 
{

  "pageSize": integer

  "pageToken": string
}
Kolom

Kolom union _page_size.

_page_size hanya dapat berupa salah satu dari hal berikut:
pageSize

integer

Opsional. Jumlah maksimum label yang akan ditampilkan.

Kolom union _page_token.

_page_token hanya dapat berupa salah satu dari hal berikut:
pageToken

string

Opsional. Token halaman untuk mengambil halaman hasil tertentu dalam daftar.

Skema Output

Pesan respons untuk ListLabels RPC.

ListLabelsResponse

Representasi JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Kolom
labels[]

object (Label)

Daftar label pengguna di akun pengguna.
nextPageToken

string

Token untuk mengambil halaman hasil berikutnya dalam daftar.

Label

Representasi JSON 
{
  "labelId": string,
  "name": string
}
Kolom
labelId

string

ID unik label.
name

string

Nama tampilan label yang dapat dibaca manusia.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌