MCP Tools Reference: gmailmcp.googleapis.com

Công cụ: get_thread

Truy xuất một chuỗi email cụ thể từ tài khoản Gmail của người dùng đã xác thực, bao gồm cả danh sách thư của chuỗi đó.

Tham số messageFormat (không bắt buộc) kiểm soát định dạng của các thông báo được trả về. Theo mặc định (hoặc với FULL_CONTENT), phương thức này sẽ trả về toàn bộ nội dung của tin nhắn. Sử dụng MINIMAL để chỉ bao gồm tiêu đề và đoạn trích (không bao gồm nội dung). Sử dụng METADATA_ONLY để chỉ bao gồm siêu dữ liệu cơ bản (mã nhận dạng thư, mã nhận dạng chuỗi thư, nhãn, dấu thời gian và ước tính kích thước).

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP get_thread.

Yêu cầu 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
}'

Giản đồ đầu vào

Thông báo yêu cầu cho RPC GetThread.

GetThreadRequest

Biểu diễn dưới dạng JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
Trường
threadId

string

Bắt buộc. Giá trị nhận dạng riêng biệt của luồng cần tìm nạp.
messageFormat

enum (MessageFormat)

Không bắt buộc. Chỉ định định dạng của các thông báo được trả về trong luồng. Giá trị mặc định là FULL_CONTENT. Lưu ý: Định dạng MINIMAL trả về id, đoạn trích, tiêu đề, người gửi, người nhận, người nhận bản sao, ngày, labelIds. Định dạng METADATA_ONLY trả về id, from, to, cc, date, labelIds. FULL_CONTENT trả về id, snippet, subject, from, to, cc, date, labelIds, attachmentIds, plaintextBody, htmlBody, attachments.

MessageFormat

Liệt kê để kiểm soát mức độ chi tiết của các thông báo trong luồng.

Enum
MESSAGE_FORMAT_UNSPECIFIED Giá trị mặc định là FULL_CONTENT.
MINIMAL Trả về đoạn trích thư và tiêu đề chính (Chủ đề, Từ, Đến, Cc, Ngày).
FULL_CONTENT Trả về tất cả thông tin trong "TỐI THIỂU" cùng với nội dung đầy đủ của từng thư.
METADATA_ONLY Chỉ siêu dữ liệu: không bao gồm tiêu đề, đoạn trích, nội dung, tên tệp đính kèm.

Giản đồ đầu ra

Luồng chứa danh sách tin nhắn.

Chuỗi hội thoại

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Trường
id

string

Giá trị nhận dạng duy nhất của chuỗi.
messages[]

object (Message)

Danh sách các tin nhắn trong chuỗi, được sắp xếp theo thứ tự thời gian.

Nhắn tin

Biểu diễn dưới dạng 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
  ]
}
Trường
id

string

Giá trị nhận dạng duy nhất của thông báo.
snippet

string

Đoạn trích nội dung thư.
subject

string

Tiêu đề thư được trích xuất từ phần đầu thư:
sender

string

Địa chỉ email của người gửi.
toRecipients[]

string

Đến địa chỉ email của người nhận.
ccRecipients[]

string

Địa chỉ email của người nhận CC.
date

string

Ngày của thông báo ở định dạng ISO 8601 (YYYY-MM-DD).
plaintextBody

string

Nội dung toàn bộ phần thân, chỉ được điền sẵn nếu MessageFormat là FULL_CONTENT.
attachmentIds[]

string

Chỉ có đầu ra. Mã nhận dạng tệp đính kèm, chỉ được điền sẵn nếu MessageFormat là FULL_CONTENT.
htmlBody

string

Nội dung HTML của email, chỉ được điền sẵn nếu MessageFormat là FULL_CONTENT.
attachments[]

object (AttachmentMetadata)

Chỉ có đầu ra. Tệp đính kèm, chỉ được điền sẵn nếu MessageFormat là FULL_CONTENT.
labelIds[]

string

Mã nhận dạng của các nhãn được đính kèm vào thư. Bao gồm mã nhận dạng của nhãn người dùng và nhãn hệ thống tiêu chuẩn, giới hạn ở INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT.

AttachmentMetadata

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Trường
id

string

Chỉ có đầu ra. Mã nhận dạng của tệp đính kèm.
mimeType

string

Loại MIME của tệp đính kèm.
filename

string

Tên tệp của tệp đính kèm.

Chú giải công cụ

Gợi ý phá hoại: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

  • 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