MCP Tools Reference: gmailmcp.googleapis.com

Alat: get_message

Mengambil pesan email tertentu dari akun Gmail pengguna yang diautentikasi berdasarkan ID pesannya yang unik.

Gunakan alat ini untuk memeriksa satu email individual jika Anda sudah mengetahui ID pesannya. Jika pengguna ingin membaca email tertentu secara mendetail, memeriksa kata-kata yang tepat dalam pesan, atau memeriksa metadata lampiran untuk satu email, alat ini adalah alat yang tepat. Alat ini tidak cocok untuk mengambil seluruh percakapan atau melihat rangkaian diskusi bolak-balik; gunakan alat 'get_thread' sebagai gantinya. Indikator utama mencakup apakah pengguna meminta konten lengkap ID pesan tertentu yang ditampilkan oleh penelusuran sebelumnya, atau apakah kueri meminta untuk memeriksa email individu tertentu, bukan seluruh rangkaian pesan. Contoh perintah pengguna adalah: "Dapatkan teks lengkap ID pesan 18f123456789abcd", "Baca pesan terbaru dalam rangkaian pesan tersebut dari Alice", dan "Apa nama lampiran dalam email yang baru saja saya terima dari HR?"

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

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

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_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Pesan permintaan untuk RPC GetMessage.

GetMessageRequest

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

string

Wajib. ID unik pesan yang akan diambil.
messageFormat

enum (MessageFormat)

Opsional. Menentukan format pesan yang ditampilkan. Default-nya adalah FULL_CONTENT.

MessageFormat

Enum untuk mengontrol tingkat detail pesan dalam rangkaian pesan.

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

Skema Output

Pesan dalam rangkaian pesan.

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

Cuplikan isi pesan.
subject

string

Subjek pesan yang diekstrak dari header:
sender

string

Alamat email pengirim.
toRecipients[]

string

Ke alamat email penerima.
ccRecipients[]

string

Alamat email penerima CC.
date

string

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

string

Konten isi pesan 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. Mencakup ID label pengguna dan label sistem standar yang dibatasi hingga 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