MCP Reference: gmailmcp.googleapis.com

เซิร์ฟเวอร์ Model Context Protocol (MCP) ทำหน้าที่เป็นพร็อกซีระหว่างบริการภายนอกที่ให้บริบท ข้อมูล หรือความสามารถแก่โมเดลภาษาขนาดใหญ่ (LLM) หรือแอปพลิเคชัน AI เซิร์ฟเวอร์ MCP จะเชื่อมต่อแอปพลิเคชัน AI กับระบบภายนอก เช่น ฐานข้อมูลและบริการเว็บ โดยแปลการตอบกลับเป็นรูปแบบที่แอปพลิเคชัน AI เข้าใจได้

เครื่องมือ MCP

เครื่องมือ MCP คือฟังก์ชันหรือความสามารถที่ดำเนินการได้ซึ่งเซิร์ฟเวอร์ MCP เปิดเผยต่อ LLM หรือแอปพลิเคชัน AI เพื่อดำเนินการในโลกแห่งความเป็นจริง

เซิร์ฟเวอร์ MCP gmailmcp.googleapis.com มีเครื่องมือต่อไปนี้

เครื่องมือ MCP
create_draft

สร้างอีเมลฉบับร่างใหม่ในบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์

เครื่องมือนี้รับอีเมลของผู้รับ หัวเรื่อง และเนื้อหาเป็นข้อมูลนำเข้า และแสดงผลรหัสของฉบับร่าง Gmail ที่สร้างขึ้น

list_drafts

แสดงรายการอีเมลฉบับร่างจากบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์

เครื่องมือนี้สามารถกรองฉบับร่างตามสตริงค้นหาและรองรับการแบ่งหน้า โดยจะแสดงรายการฉบับร่าง รวมถึงรหัสและหัวเรื่อง

get_thread ดึงข้อมูลชุดข้อความอีเมลที่เฉพาะเจาะจงจากบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ รวมถึงรายการข้อความในชุดข้อความ
search_threads

แสดงรายการชุดข้อความอีเมลจากบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์

เครื่องมือนี้สามารถกรองชุดข้อความตามสตริงค้นหาและรองรับการแบ่งหน้า โดยจะแสดงรายการชุดข้อความ รวมถึงรหัสและข้อความที่เกี่ยวข้อง ข้อความที่เกี่ยวข้องแต่ละข้อความจะมีรายละเอียดต่างๆ เช่น ข้อมูลสรุปของเนื้อหาข้อความ หัวเรื่อง ผู้ส่ง ผู้รับ เป็นต้น โปรดทราบว่าเครื่องมือนี้จะไม่แสดงเนื้อหาข้อความฉบับเต็ม หากต้องการดึงข้อมูลเนื้อหาข้อความฉบับเต็ม ให้ใช้เครื่องมือ "get_thread" กับรหัสชุดข้อความ

label_thread

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

หากไม่แน่ใจเกี่ยวกับรหัสชุดข้อความ ให้ใช้เครื่องมือ search_threads ก่อน

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

unlabel_thread นำป้ายกำกับออกจากชุดข้อความทั้งหมดในบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ หากไม่แน่ใจเกี่ยวกับรหัสชุดข้อความ ให้ใช้เครื่องมือ search_threads ก่อน หากไม่แน่ใจเกี่ยวกับรหัสป้ายกำกับของผู้ใช้ ให้ใช้เครื่องมือ list_labels ก่อน
list_labels แสดงรายการป้ายกำกับทั้งหมดที่ผู้ใช้กำหนดไว้ซึ่งพร้อมใช้งานในบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ ใช้เครื่องมือนี้เพื่อค้นหา id ของป้ายกำกับของผู้ใช้ก่อนที่จะเรียก label_thread, unlabel_thread, label_message, หรือ unlabel_message เครื่องมือนี้จะไม่แสดงป้ายกำกับของระบบ แต่สามารถใช้กับรหัสที่รู้จักกันดีต่อไปนี้ได้ 'INBOX', 'TRASH', 'SPAM', 'STARRED', 'UNREAD', 'IMPORTANT', 'CHAT', 'DRAFT', 'SENT'
label_message

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

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

unlabel_message นำป้ายกำกับอย่างน้อย 1 รายการออกจากข้อความที่เฉพาะเจาะจงในบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ หากต้องการค้นหารหัสข้อความ ให้ใช้เครื่องมือต่างๆ เช่น search_threads หรือ get_thread หากไม่แน่ใจเกี่ยวกับรหัสป้ายกำกับของผู้ใช้ ให้ใช้เครื่องมือ list_labels ก่อนเพื่อค้นหาป้ายกำกับที่พร้อมใช้งานและรหัสของป้ายกำกับ
create_label สร้างป้ายกำกับใหม่ในบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์

ดูข้อมูลจำเพาะของเครื่องมือ MCP

หากต้องการดูข้อมูลจำเพาะของเครื่องมือ MCP สำหรับเครื่องมือทั้งหมดในเซิร์ฟเวอร์ MCP ให้ใช้เมธอด tools/list ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อแสดงรายการเครื่องมือทั้งหมดและข้อมูลจำเพาะของเครื่องมือที่พร้อมใช้งานในเซิร์ฟเวอร์ MCP ในปัจจุบัน

คำขอ Curl
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'