MCP Tools Reference: gmailmcp.googleapis.com

เครื่องมือ: get_message

ดึงข้อมูลอีเมลที่เฉพาะเจาะจงจากบัญชี Gmail ของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ด้วยรหัสข้อความที่ไม่ซ้ำกัน

ใช้เครื่องมือนี้เพื่อตรวจสอบอีเมลฉบับเดียวเมื่อคุณทราบรหัสข้อความของอีเมลนั้นอยู่แล้ว เครื่องมือนี้เหมาะสำหรับกรณีที่ผู้ใช้ต้องการอ่านอีเมลที่เฉพาะเจาะจงโดยละเอียด ตรวจสอบการใช้คำที่แน่นอนของข้อความ หรือตรวจสอบข้อมูลเมตาของไฟล์แนบสำหรับอีเมลฉบับเดียว แต่ไม่เหมาะสำหรับการดึงข้อมูลการสนทนาทั้งหมดหรือดูชุดข้อความสนทนาไปมา ให้ใช้เครื่องมือ "get_thread" แทน ตัวบ่งชี้ที่สำคัญ ได้แก่ กรณีที่ผู้ใช้ขอเนื้อหาทั้งหมดของรหัสข้อความที่เฉพาะเจาะจงซึ่งการค้นหาก่อนหน้านี้แสดงผล หรือกรณีที่คําค้นหาขอให้ตรวจสอบอีเมลฉบับเดียวที่เฉพาะเจาะจงแทนที่จะเป็นทั้งชุดข้อความ ตัวอย่างข้อความแจ้งของผู้ใช้ ได้แก่ "แสดงข้อความแบบเต็มของรหัสข้อความ 18f123456789abcd" "อ่านข้อความล่าสุดในชุดข้อความนั้นจาก Alice" และ "ไฟล์แนบในอีเมลที่ฉันเพิ่งได้รับจากฝ่ายบุคคลชื่ออะไร"

พารามิเตอร์ messageFormat ที่ไม่บังคับจะควบคุมรูปแบบของข้อความที่แสดงผล โดยค่าเริ่มต้น (หรือเมื่อใช้ FULL_CONTENT) ระบบจะแสดงเนื้อหาทั้งหมดของข้อความ ใช้ MINIMAL เพื่อรวมเฉพาะเรื่องและข้อมูลสรุป (ไม่รวมเนื้อความ) ใช้ METADATA_ONLY เพื่อรวมเฉพาะข้อมูลเมตาพื้นฐาน (รหัสข้อความ, รหัสชุดข้อความ, ป้ายกำกับ, การประทับเวลา และขนาดโดยประมาณ)

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ get_message MCP

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

สคีมาอินพุต

ข้อความคำขอสำหรับ GetMessage RPC

GetMessageRequest

การแสดง JSON 
{
  "messageId": string,
  "messageFormat": enum (MessageFormat)
}
ช่อง
messageId

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันของข้อความที่จะดึงข้อมูล
messageFormat

enum (MessageFormat)

ไม่บังคับ ระบุรูปแบบของข้อความที่แสดงผล ค่าเริ่มต้นคือ FULL_CONTENT

MessageFormat

Enum เพื่อควบคุมระดับรายละเอียดของข้อความในชุดข้อความ

Enum
MESSAGE_FORMAT_UNSPECIFIED ค่าเริ่มต้นคือ FULL_CONTENT
MINIMAL แสดงข้อมูลสรุปของข้อความและส่วนหัวหลัก (เรื่อง, จาก, ถึง, สำเนา, วันที่)
FULL_CONTENT แสดงข้อมูลทั้งหมดใน "MINIMAL" รวมถึงเนื้อหาทั้งหมดของแต่ละข้อความ
METADATA_ONLY ข้อมูลเมตาเท่านั้น: ไม่รวมเรื่อง ข้อมูลสรุป เนื้อความ ชื่อไฟล์แนบ

สคีมาเอาต์พุต

ข้อความภายในชุดข้อความ

ข้อความ

การแสดง 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
  ]
}
ช่อง
id

string

ตัวระบุที่ไม่ซ้ำกันของข้อความ
snippet

string

ข้อมูลสรุปของเนื้อความ
subject

string

เรื่องของข้อความที่ดึงข้อมูลจากส่วนหัว
sender

string

อีเมลของผู้ส่ง
toRecipients[]

string

อีเมลของผู้รับ
ccRecipients[]

string

อีเมลของผู้รับสำเนา
date

string

วันที่ของข้อความในรูปแบบ ISO 8601 (YYYY-MM-DD)
plaintextBody

string

เนื้อหาทั้งหมดของเนื้อความ โดยจะแสดงข้อมูลในช่องนี้ก็ต่อเมื่อ MessageFormat เป็น FULL_CONTENT
attachmentIds[]

string

เอาต์พุตเท่านั้น รหัสไฟล์แนบ โดยจะแสดงข้อมูลในช่องนี้ก็ต่อเมื่อ MessageFormat เป็น FULL_CONTENT
htmlBody

string

เนื้อหา HTML ของอีเมล โดยจะแสดงข้อมูลในช่องนี้ก็ต่อเมื่อ MessageFormat เป็น FULL_CONTENT
attachments[]

object (AttachmentMetadata)

เอาต์พุตเท่านั้น ไฟล์แนบ โดยจะแสดงข้อมูลในช่องนี้ก็ต่อเมื่อ MessageFormat เป็น FULL_CONTENT
labelIds[]

string

รหัสของป้ายกำกับที่แนบกับข้อความ รวมถึงรหัสของป้ายกำกับของผู้ใช้และป้ายกำกับระบบมาตรฐานที่จำกัดไว้เฉพาะ INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT

AttachmentMetadata

การแสดง JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
ช่อง
id

string

เอาต์พุตเท่านั้น รหัสของไฟล์แนบ
mimeType

string

ประเภท MIME ของไฟล์แนบ
filename

string

ชื่อไฟล์ของไฟล์แนบ

คำอธิบายประกอบของเครื่องมือ

คำแนะนำที่อาจทำให้เกิดการเปลี่ยนแปลง: ❌ | คำแนะนำที่อาจทำให้เกิดการเปลี่ยนแปลงซ้ำได้: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบเปิด: ❌

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • 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