MCP Tools Reference: gmailmcp.googleapis.com

Công cụ: label_message

Thêm một hoặc nhiều nhãn vào một thư cụ thể trong tài khoản Gmail của người dùng đã xác thực.

Để tìm mã nhận dạng thư, hãy sử dụng các công cụ như search_threads hoặc get_thread. Nếu không chắc chắn về mã nhận dạng của nhãn người dùng, trước tiên, hãy sử dụng công cụ list_labels để khám phá các nhãn hiện có và mã nhận dạng của chúng. Để thêm nhãn thùng rác hoặc nhãn thư rác vào một thư, vui lòng sử dụng công cụ apply_sensitive_message_label.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP label_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": "label_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 RPC LabelMessage.

LabelMessageRequest

Biểu diễn dưới dạng JSON 
{
  "messageId": string,
  "labelIds": [
    string
  ]
}
Trường
messageId

string

Bắt buộc. Mã của thư cần thêm nhãn.
labelIds[]

string

Bắt buộc. Mã nhận dạng của các nhãn cần thêm. Có thể là mã nhận dạng nhãn hệ thống (ví dụ: "INBOX", "STARRED", "UNREAD", "IMPORTANT") hoặc mã nhận dạng nhãn do người dùng xác định. Công cụ này chấp nhận label_ids chứ không chấp nhận tên nhãn. Sử dụng công cụ list_labels để lấy mã nhận dạng nhãn tương ứng cho tên hiển thị của nhãn do người dùng xác định.

Giản đồ đầu ra

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

Chú giải công cụ

Gợi ý mang tính huỷ diệt: ❌ | Gợi ý mang tính luỹ đẳng: ✅ | Gợi ý chỉ đọc: ❌ | Gợi ý về 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