MCP Tools Reference: gmailmcp.googleapis.com

เครื่องมือ: label_message

เพิ่มป้ายกำกับอย่างน้อย 1 รายการไปยังข้อความที่เฉพาะเจาะจงในบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์

หากต้องการค้นหารหัสข้อความ ให้ใช้เครื่องมืออย่าง search_threads หรือ get_thread หากไม่แน่ใจเกี่ยวกับรหัสของป้ายกำกับผู้ใช้ ให้ใช้list_labelsเครื่องมือก่อนเพื่อค้นหาป้ายกำกับที่มีอยู่และรหัสของป้ายกำกับเหล่านั้น หากต้องการเพิ่มป้ายกำกับถังขยะหรือป้ายกำกับจดหมายขยะในข้อความ โปรดใช้apply_sensitive_message_labelแทน

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ label_message MCP

คำขอ 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
}'

สคีมาอินพุต

ข้อความคำขอสำหรับ RPC ของ LabelMessage

LabelMessageRequest

การแสดง JSON 
{
  "messageId": string,
  "labelIds": [
    string
  ]
}
ช่อง
messageId

string

ต้องระบุ รหัสของข้อความที่จะเพิ่มป้ายกำกับ
labelIds[]

string

ต้องระบุ รหัสของป้ายกำกับที่จะเพิ่ม อาจเป็นรหัสป้ายกำกับของระบบ (เช่น "INBOX" "STARRED" "UNREAD" "IMPORTANT") หรือรหัสป้ายกำกับที่ผู้ใช้กำหนด เครื่องมือนี้ยอมรับ label_ids แต่ไม่ยอมรับชื่อค่ายเพลง ใช้เครื่องมือ list_labels เพื่อรับรหัสป้ายกำกับที่เกี่ยวข้องกับชื่อที่แสดงสำหรับป้ายกำกับที่ผู้ใช้กำหนด

สคีมาเอาต์พุต

ข้อความตอบกลับสำหรับ RPC ของ LabelMessage

คำอธิบายประกอบเครื่องมือ

คำใบ้ที่ทำลาย: ❌ | คำใบ้ที่ทำซ้ำได้: ✅ | คำใบ้แบบอ่านอย่างเดียว: ❌ | คำใบ้แบบโลกเปิด: ❌

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify