MCP Tools Reference: gmailmcp.googleapis.com

Alat: get_thread

Mengambil rangkaian pesan email tertentu dari akun Gmail pengguna yang diautentikasi, termasuk daftar pesannya.

Parameter messageFormat opsional mengontrol format pesan yang ditampilkan. Secara default (atau dengan FULL_CONTENT), parameter ini menampilkan konten lengkap pesan. Gunakan MINIMAL untuk hanya menyertakan subjek dan ringkasan (tidak termasuk isi). Gunakan METADATA_ONLY untuk hanya menyertakan metadata dasar (ID pesan, ID rangkaian pesan, label, stempel waktu, dan perkiraan ukuran).

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

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

Skema Input

Pesan permintaan untuk GetThread RPC.

GetThreadRequest

Representasi JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
Kolom
threadId

string

Wajib. ID unik rangkaian pesan yang akan diambil.
messageFormat

enum (MessageFormat)

Opsional. Menentukan format pesan yang ditampilkan dalam rangkaian pesan. Default-nya adalah FULL_CONTENT. Catatan: Format MINIMAL menampilkan id, snippet, subject, from, to, cc, date, labelIds. Format METADATA_ONLY menampilkan id, from, to, cc, date, labelIds. FULL_CONTENT menampilkan id, snippet, subject, from, to, cc, date, labelIds, attachmentIds, plaintextBody, htmlBody, attachments.

MessageFormat

Enum untuk mengontrol tingkat detail pesan dalam rangkaian pesan.

Enum
MESSAGE_FORMAT_UNSPECIFIED Default-nya adalah FULL_CONTENT.
MINIMAL Menampilkan ringkasan pesan dan header utama (Subjek, Dari, Kepada, Cc, Tanggal).
FULL_CONTENT Menampilkan semua informasi di "MINIMAL" ditambah konten isi lengkap setiap pesan.
METADATA_ONLY Hanya metadata: tidak menyertakan subjek, ringkasan, isi, nama file lampiran.

Skema Output

Rangkaian pesan yang berisi daftar pesan.

Rangkaian pesan

Representasi JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Kolom
id

string

ID unik rangkaian pesan.
messages[]

object (Message)

Daftar pesan dalam rangkaian pesan, diurutkan secara kronologis.

Pesan

Representasi JSON 
{
  "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
  ]
}
Kolom
id

string

ID unik pesan.
snippet

string

Ringkasan isi pesan.
subject

string

Subjek pesan yang diekstrak dari header:
sender

string

Alamat email pengirim.
toRecipients[]

string

Alamat email penerima.
ccRecipients[]

string

Alamat email penerima CC.
date

string

Tanggal pesan dalam format ISO 8601 (YYYY-MM-DD).
plaintextBody

string

Konten isi lengkap, hanya diisi jika MessageFormat adalah FULL_CONTENT.
attachmentIds[]

string

Hanya output. ID lampiran, hanya diisi jika MessageFormat adalah FULL_CONTENT.
htmlBody

string

Konten HTML email, hanya diisi jika MessageFormat adalah FULL_CONTENT.
attachments[]

object (AttachmentMetadata)

Hanya output. Lampiran, hanya diisi jika MessageFormat adalah FULL_CONTENT.
labelIds[]

string

ID label yang dilampirkan ke pesan. Menyertakan ID label pengguna dan label sistem standar yang dibatasi ke INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT.

AttachmentMetadata

Representasi JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Kolom
id

string

Hanya output. ID lampiran.
mimeType

string

Jenis MIME lampiran.
filename

string

Nama file lampiran.

Anotasi Alat

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

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • 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