MCP Tools Reference: gmailmcp.googleapis.com

Công cụ: get_message

Truy xuất một nội dung email cụ thể từ Tài khoản Gmail của người dùng đã xác thực theo mã thư duy nhất.

Hãy sử dụng công cụ này để kiểm tra một email riêng lẻ khi bạn đã biết mã thư của email đó. Đây là công cụ phù hợp nếu người dùng muốn đọc chi tiết một email cụ thể, kiểm tra chính xác nội dung của một thư hoặc xem xét siêu dữ liệu tệp đính kèm của một email. Công cụ này không phù hợp để truy xuất toàn bộ cuộc trò chuyện hoặc xem các chuỗi thảo luận qua lại; thay vào đó, hãy sử dụng công cụ "get_thread". Các chỉ báo chính bao gồm việc người dùng yêu cầu xem toàn bộ nội dung của một mã thư cụ thể do một lượt tìm kiếm trước đó trả về, hoặc nếu cụm từ tìm kiếm yêu cầu kiểm tra một email cụ thể thay vì toàn bộ chuỗi thư. Ví dụ về câu lệnh cho người dùng: "Lấy toàn bộ nội dung của thông báo có mã nhận dạng 18f123456789abcd.", "Đọc tin nhắn mới nhất trong chuỗi đó của Alice" và "Tên của các tệp đính kèm trong email tôi vừa nhận được từ phòng Nhân sự là gì?"

Tham số messageFormat không bắt buộc sẽ kiểm soát định dạng của 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 thông báo. 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_message.

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_message",
    "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 GetMessage RPC.

GetMessageRequest

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

string

Bắt buộc. Giá trị nhận dạng duy nhất của thông báo cần tìm nạp.
messageFormat

enum (MessageFormat)

Không bắt buộc. Chỉ định định dạng của thông báo được trả về. Giá trị mặc định là FULL_CONTENT.

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

Tin nhắn trong một chuỗi tin nhắn.

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