MCP Tools Reference: gmailmcp.googleapis.com

Araç: get_thread

Kimliği doğrulanmış kullanıcının Gmail hesabından belirli bir e-posta ileti dizisini (ileti listesi dahil) alır.

İsteğe bağlı messageFormat parametresi, döndürülen mesajların biçimini kontrol eder. Varsayılan olarak (veya FULL_CONTENT ile) iletilerin tam içeriğini döndürür. Yalnızca konuyu ve snippet'i (gövde hariç) dahil etmek için MINIMAL simgesini kullanın. Yalnızca temel meta verileri (mesaj kimliği, ileti dizisi kimliği, etiketler, zaman damgası ve boyut tahmini) eklemek için METADATA_ONLY kullanın.

Aşağıdaki örnekte, get_thread 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": "get_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

GetThread RPC için istek mesajı.

GetThreadRequest

JSON gösterimi 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
Alanlar
threadId

string

Zorunlu. Getirilecek ileti dizisinin benzersiz tanımlayıcısı.
messageFormat

enum (MessageFormat)

İsteğe bağlı. İleti dizisinde döndürülen iletilerin biçimini belirtir. Varsayılan olarak FULL_CONTENT değerine ayarlanır. Not: MINIMAL biçimi; id, snippet, subject, from, to, cc, date, labelIds değerlerini döndürür. METADATA_ONLY biçimi; id, from, to, cc, date, labelIds değerlerini döndürür. FULL_CONTENT; id, snippet, subject, from, to, cc, date, labelIds, attachmentIds, plaintextBody, htmlBody, attachments değerlerini döndürür.

MessageFormat

İleti dizisindeki iletilerin ayrıntı düzeyini kontrol etmek için kullanılan enum.

Sıralamalar
MESSAGE_FORMAT_UNSPECIFIED Varsayılan olarak FULL_CONTENT değerine ayarlanır.
MINIMAL İleti snippet'lerini ve önemli üstbilgileri (Konu, Gönderen, Alıcı, Cc, Tarih) döndürür.
FULL_CONTENT "MINIMAL" (En Az) seçeneğindeki tüm bilgilerin yanı sıra her iletinin tam gövde içeriğini döndürür.
METADATA_ONLY Yalnızca meta veriler: Konu, snippet, gövde ve ek dosya adları dahil değildir.

Çıkış Şeması

İleti listesini içeren ileti dizisi.

İplik

JSON gösterimi 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Alanlar
id

string

İş parçacığının benzersiz tanımlayıcısı.
messages[]

object (Message)

İleti dizisindeki mesajların kronolojik olarak sıralanmış listesi.

Mesaj

JSON gösterimi 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    string
  ]
}
Alanlar
id

string

Mesajın benzersiz tanımlayıcısı.
snippet

string

E-posta mesajının snippet'i.
subject

string

Üstbilgilerden çıkarılan ileti konusu:
sender

string

Gönderenin e-posta adresi.
toRecipients[]

string

Alıcı e-posta adresleri
ccRecipients[]

string

CC alıcılarının e-posta adresleri.
date

string

İletinin ISO 8601 biçimindeki tarihi (YYYY-AA-GG).
plaintextBody

string

İletinin tam içeriği. Yalnızca MessageFormat FULL_CONTENT ise doldurulur.
attachmentIds[]

string

Yalnızca çıkış. Ek kimlikleri, yalnızca MessageFormat FULL_CONTENT ise doldurulur.
htmlBody

string

E-postanın HTML içeriği. Yalnızca MessageFormat FULL_CONTENT ise doldurulur.
attachments[]

object (AttachmentMetadata)

Yalnızca çıkış. Ekler, yalnızca MessageFormat FULL_CONTENT ise doldurulur.
labelIds[]

string

İletiye eklenen etiketlerin kimlikleri. INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT ile sınırlı kullanıcı etiketlerinin ve standart sistem etiketlerinin kimliklerini içerir.

AttachmentMetadata

JSON gösterimi 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Alanlar
id

string

Yalnızca çıkış. Ekin kimliği.
mimeType

string

Ekin MIME türü.
filename

string

Ekin dosya adı.

Araç Ek Açıklamaları

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

Yetkilendirme Kapsamları

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

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