MCP Tools Reference: gmailmcp.googleapis.com

Araç: get_message

Kimliği doğrulanmış kullanıcının Gmail hesabındaki belirli bir e-posta iletisini benzersiz ileti kimliğiyle alır.

İleti kimliğini bildiğiniz tek bir e-postayı incelemek için bu aracı kullanın. Kullanıcı belirli bir e-postayı ayrıntılı olarak okumak, iletinin tam metnini kontrol etmek veya tek bir e-postanın ek meta verilerini incelemek istiyorsa bu araç doğru seçimdir. Bu araç, görüşmelerin tamamını almak veya karşılıklı tartışma dizilerini görüntülemek için uygun değildir. Bunun yerine "get_thread" aracını kullanın. Kullanıcının önceki bir arama tarafından döndürülen belirli bir ileti kimliğinin tam içeriğini isteyip istemediği veya sorguda, ileti dizisinin tamamı yerine belirli bir e-postanın incelenmesinin istenip istenmediği gibi göstergeler önemlidir. Örnek kullanıcı istemleri: "18f123456789abcd mesaj kimliğinin tam metnini al.", "Read the latest message in that thread from Alice." (Bu ileti dizisindeki Ayşe'den gelen son mesajı oku.) ve "What are the attachment names in the email I just received from HR?" (İK'dan aldığım e-postadaki eklerin adları neler?)

İsteğe bağlı messageFormat parametresi, döndürülen mesajın biçimini kontrol eder. Varsayılan olarak (veya FULL_CONTENT ile) iletinin 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_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": "get_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

GetMessage RPC için istek mesajı.

GetMessageRequest

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

string

Zorunlu. Getirilecek mesajın benzersiz tanımlayıcısı.
messageFormat

enum (MessageFormat)

İsteğe bağlı. Döndürülen mesajın biçimini belirtir. Varsayılan olarak FULL_CONTENT değerine ayarlanı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ını içermez.

Çıkış Şeması

İleti dizisindeki mesajlar

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