MCP Tools Reference: gmailmcp.googleapis.com

Araç: list_labels

Kimliği doğrulanmış kullanıcının Gmail hesabında bulunan, kullanıcı tanımlı tüm etiketleri listeler. label_thread, unlabel_thread, label_message veya unlabel_message yöntemini çağırmadan önce kullanıcı etiketinin id değerini bulmak için bu aracı kullanın. Sistem etiketleri bu araç tarafından döndürülmez ancak bilinen kimlikleriyle kullanılabilir: "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT".

Aşağıdaki örnekte, curl kullanılarak list_labels MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

ListLabels RPC için istek mesajı.

ListLabelsRequest

JSON gösterimi 
{

  "pageSize": integer

  "pageToken": string
}
Alanlar

_page_size birleşik alanı.

_page_size aşağıdakilerden yalnızca biri olabilir:
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum etiket sayısı.

_page_token birleşik alanı.

_page_token aşağıdakilerden yalnızca biri olabilir:
pageToken

string

İsteğe bağlı. Listedeki belirli bir sonuç sayfasını almak için kullanılan sayfa jetonu.

Çıkış şeması

ListLabels RPC'si için yanıt mesajı.

ListLabelsResponse

JSON gösterimi 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Alanlar
labels[]

object (Label)

Kullanıcının hesabındaki kullanıcı etiketlerinin listesi.
nextPageToken

string

Listedeki sonuçların sonraki sayfasını almak için kullanılan jeton.

Şirket

JSON gösterimi 
{
  "labelId": string,
  "name": string,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
Alanlar
labelId

string

Etiketin benzersiz tanımlayıcısı.
name

string

Etiketin, kullanıcılar tarafından okunabilir görünen adı.
color

object (LabelColor)

İsteğe bağlı. Etiketin rengi.

_threads_total birleşik alanı.

_threads_total aşağıdakilerden yalnızca biri olabilir:
threadsTotal

integer

Etiket altındaki toplam ileti sayısı.

_threads_unread birleşik alanı.

_threads_unread aşağıdakilerden yalnızca biri olabilir:
threadsUnread

integer

Etiket altındaki okunmamış ileti dizilerinin sayısı.

LabelColor

JSON gösterimi 
{
  "textColor": string,
  "backgroundColor": string
}
Alanlar
textColor

string

Etiketin metin rengi, onaltılık dize olarak gösterilir (ör. "#000000").
backgroundColor

string

Etiketin arka plan rengi, onaltılık dize olarak gösterilir (ör. "#ffffff").

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌