MCP Tools Reference: gmailmcp.googleapis.com

Công cụ: search_threads

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

Công cụ này có thể lọc các chuỗi dựa trên một chuỗi truy vấn và hỗ trợ phân trang. Công cụ này trả về một danh sách các chuỗi, bao gồm cả mã nhận dạng và tin nhắn liên quan. Mỗi tin nhắn liên quan chứa các thông tin chi tiết như trích đoạn nội dung thư, tiêu đề, người gửi, người nhận, v.v. Xin lưu ý rằng công cụ này không trả về toàn bộ nội dung thư. Hãy sử dụng công cụ "get_thread" với mã chuỗi để tìm nạp toàn bộ nội dung thư nếu cần.

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

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": "search_threads",
    "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 SearchThreads RPC.

SearchThreadsRequest

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

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
Trường

Trường nhóm _page_size.

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

integer

Không bắt buộc. Số lượng chuỗi tối đa cần trả về. Nếu không được 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 giá trị sau:
pageToken

string

Không bắt buộc. Mã thông báo trang để truy xuất một trang kết quả cụ thể trong danh sách. Để 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 giá trị sau:
query

string

Không bắt buộc. Một chuỗi truy vấn để lọc các chuỗi, sử dụng cùng một định dạng như thanh tìm kiếm trong Gmail. Nếu bạn bỏ qua, tất cả các chuỗi (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 được 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 có 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"

Trường nhóm _include_trash.

_include_trash chỉ có thể là một trong những giá trị sau:
includeTrash

boolean

Không bắt buộc. Bao gồm cả bản nháp trong THÙNG RÁC trong kết quả. Giá trị mặc định là "false".

Giản đồ đầu ra

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

SearchThreadsResponse

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

object (Thread)

Danh sách tóm tắt chuỗi.
nextPageToken

string

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

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 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
}
Trường
id

string

Giá trị nhận dạng duy nhất của tin nhắn.
snippet

string

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

string

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

string

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

string

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

string

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

string

Ngày của tin nhắn ở định dạng ISO 8601 (YYYY-MM-DD).
plaintextBody

string

Nội dung đầy đủ, chỉ được điền nếu MessageFormat là FULL_CONTENT.

Chú thích công cụ

Gợi ý mang tính phá hoại: ❌ | Gợi ý về tính chất luỹ đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌