MCP Tools Reference: gmailmcp.googleapis.com

Araç: label_message

Kimliği doğrulanmış kullanıcının Gmail hesabındaki belirli bir iletiye bir veya daha fazla etiket ekler.

İleti kimliğini bulmak için search_threads veya get_thread gibi araçları kullanın. Bir kullanıcı etiketinin kimliğinden emin değilseniz önce list_labels aracını kullanarak mevcut etiketleri ve kimliklerini keşfedin. İletiye çöp kutusu etiketi veya spam etiketi eklemek için lütfen apply_sensitive_message_label aracını kullanın.

Aşağıdaki örnekte, label_message MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "label_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

LabelMessage RPC için istek mesajı.

LabelMessageRequest

JSON gösterimi 
{
  "messageId": string,
  "labelIds": [
    string
  ]
}
Alanlar
messageId

string

Zorunlu. Etiketlerin ekleneceği iletinin kimliği.
labelIds[]

string

Zorunlu. Eklenecek etiketlerin kimlikleri. Sistem etiketi kimliği (ör. "INBOX", "STARRED", "UNREAD", "IMPORTANT") veya kullanıcı tanımlı etiket kimliği olabilir. Araç, etiket adlarını değil label_ids değerini kabul eder. Kullanıcı tanımlı etiketlerin görünen adıyla ilgili etiketin kimliğini almak için list_labels aracını kullanın.

Çıkış Şeması

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

Araç Ek Açıklamaları

Yıkıcı ipucu: ❌ | İdempotent ipucu: ✅ | Salt okunur ipucu: ❌ | Açık dünya ipucu: ❌

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify