MCP Tools Reference: gmailmcp.googleapis.com

Công cụ: list_drafts

Liệt kê email nháp từ tài khoản Gmail của người dùng đã xác thực.

Công cụ này có thể lọc thư nháp dựa trên một chuỗi truy vấn và hỗ trợ phân trang. Công cụ này trả về danh sách thư nháp, bao gồm cả mã nhận dạng và tiêu đề của thư nháp.

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

Yêu cầu Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_drafts",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

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

ListDraftsRequest

Biểu diễn dưới dạng JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
Trường

Trường nhóm _page_size.

_page_size chỉ có thể là một trong những trường sau:
pageSize

integer

Không bắt buộc. Số lượng thư nháp tối đa cần trả về. Nếu không chỉ định, giá trị mặc định là 20. Giá trị tối đa được phép là 50.

Trường nhóm _page_token.

_page_token chỉ có thể là một trong những trường sau:
pageToken

string

Không bắt buộc. Mã thông báo nhận được từ một lệnh gọi list_drafts trước đó để truy xuất trang kết quả tiếp theo. Để trống để tìm nạp trang đầu tiên.

Trường nhóm _query.

_query chỉ có thể là một trong những trường sau:
query

string

Không bắt buộc. Một chuỗi truy vấn để lọc thư nháp, sử dụng cùng định dạng như thanh tìm kiếm trong Gmail. Nếu bạn bỏ qua, tất cả thư nháp (ngoại trừ thư rác và thư trong thùng rác theo mặc định) sẽ được liệt kê. Toán tử chính: from: – Tin nhắn của một người gửi cụ thể. to: – Tin nhắn gửi đến một người nhận cụ thể. subject: – Tin nhắn có các từ cụ thể trong tiêu đề. – Tin nhắn chứa các từ cụ thể trong nội dung hoặc tiêu đề. is:unread – Tin nhắn chưa đọc. is:starred – Tin nhắn được gắn dấu sao. has:attachment – Tin nhắn có tệp đính kèm. after:YYYY/MM/DD – Tin nhắn được gửi sau một ngày. before:YYYY/MM/DD – Tin nhắn được gửi trước một ngày. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

Giản đồ đầu ra

Thông báo phản hồi cho ListDrafts RPC.

ListDraftsResponse

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

object (Draft)

Danh sách thư nháp.
nextPageToken

string

Mã thông báo có thể được dùng trong một lệnh gọi tiếp theo để truy xuất trang thư nháp tiếp theo. Chỉ xuất hiện nếu có thêm kết quả.

Bản nháp

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
Trường
id

string

Mã nhận dạng duy nhất của tài nguyên thư nháp.
subject

string

Dòng tiêu đề của thư nháp.
threadId

string

Mã của chuỗi thư mà thư nháp này thuộc về.
toRecipients[]

string

Danh sách địa chỉ email của người nhận trong trường "Đến" được trích xuất từ tiêu đề.
ccRecipients[]

string

Danh sách địa chỉ email của người nhận trong trường "Cc" được trích xuất từ tiêu đề.
bccRecipients[]

string

Danh sách địa chỉ email của người nhận trong trường "Bcc" được trích xuất từ tiêu đề.
plaintextBody

string

Nội dung văn bản thuần tuý (nếu có).
date

string

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

Chú thích công cụ

Gợi ý mang tính huỷ diệt: ❌ | Gợi ý về tính luỹ đẳng: ❌ | Gợi ý chỉ đọc: ❌ | Gợi ý về thế giới mở: ❌