MCP Tools Reference: gmailmcp.googleapis.com

כלי: get_message

אחזור של הודעת אימייל ספציפית מחשבון Gmail של המשתמש המאומת לפי מזהה ההודעה הייחודי שלה.

אפשר להשתמש בכלי הזה כדי לבדוק הודעת אימייל ספציפית כשכבר יודעים את מזהה ההודעה שלה. אם המשתמש רוצה לקרוא אימייל ספציפי בפירוט, לבדוק את הניסוח המדויק של הודעה או לבחון את מטא-נתוני הקובץ המצורף של אימייל יחיד, זה הכלי המתאים. הכלי לא מתאים לאחזור של שיחות שלמות או לצפייה בשרשורי דיונים. במקרים כאלה, צריך להשתמש בכלי get_thread. בין האינדיקטורים העיקריים: אם המשתמש מבקש את התוכן המלא של מזהה הודעה ספציפי שהוחזר על ידי חיפוש קודם, או אם השאילתה מבקשת לבדוק אימייל ספציפי ולא שרשור שלם. דוגמאות להנחיות למשתמשים: "קבל את הטקסט המלא של הודעה עם מזהה 18f123456789abcd", "תקרא את ההודעה האחרונה בשרשור הזה מעינת" ו "מה שמות הקבצים המצורפים באימייל שקיבלתי עכשיו ממחלקת משאבי אנוש?"

הפרמטר האופציונלי messageFormat קובע את הפורמט של ההודעה שמוחזרת. כברירת מחדל (או עם FULL_CONTENT), הפונקציה מחזירה את התוכן המלא של ההודעה. כדי לכלול רק את הנושא ואת התקציר (לא את גוף האימייל) משתמשים בדגל MINIMAL. משתמשים ב-METADATA_ONLY כדי לכלול רק מטא-נתונים בסיסיים (מזהה ההודעה, מזהה השרשור, תוויות, חותמת זמן ואומדן הגודל).

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ get_message.

בקשת 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": "get_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

הודעת בקשה ל-RPC של GetMessage.

GetMessageRequest

ייצוג ב-JSON 
{
  "messageId": string,
  "messageFormat": enum (MessageFormat)
}
שדות
messageId

string

חובה. המזהה הייחודי של ההודעה שיש לאחזר.
messageFormat

enum (MessageFormat)

אופציונלי. מציין את הפורמט של ההודעה שמוחזרת. ברירת המחדל היא FULL_CONTENT.

MessageFormat

סוג הנתונים Enum שקובע את רמת הפירוט של ההודעות בשרשור.

טיפוסים בני מנייה (enum)
MESSAGE_FORMAT_UNSPECIFIED ברירת המחדל היא FULL_CONTENT.
MINIMAL הפונקציה מחזירה קטעי הודעות וכותרות מפתח (נושא, מאת, אל, עותק, תאריך).
FULL_CONTENT מחזירה את כל המידע ב-MINIMAL בתוספת התוכן המלא של גוף כל הודעה.
METADATA_ONLY מטא-נתונים בלבד: לא כולל את הנושא, קטע הטקסט, גוף ההודעה ושמות הקבצים המצורפים.

סכימת הפלט

הודעה בשרשור.

שליחת הודעה

ייצוג ב-JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    string
  ]
}
שדות
id

string

המזהה הייחודי של ההודעה.
snippet

string

קטע מגוף ההודעה.
subject

string

נושא ההודעה שחולץ מהכותרות:
sender

string

כתובת האימייל של השולח.
toRecipients[]

string

כתובות האימייל של הנמענים.
ccRecipients[]

string

כתובות האימייל של הנמענים בשדה 'עותק'.
date

string

תאריך ההודעה בפורמט ISO 8601‏ (YYYY-MM-DD).
plaintextBody

string

תוכן מלא של גוף ההודעה, מאוכלס רק אם MessageFormat היה FULL_CONTENT.
attachmentIds[]

string

פלט בלבד. מזהי הקבצים המצורפים, מאוכלסים רק אם MessageFormat היה FULL_CONTENT.
htmlBody

string

תוכן ה-HTML של האימייל, מאוכלס רק אם MessageFormat היה FULL_CONTENT.
attachments[]

object (AttachmentMetadata)

פלט בלבד. הקבצים המצורפים, מאוכלסים רק אם MessageFormat היה FULL_CONTENT.
labelIds[]

string

המזהים של התוויות שמצורפות להודעה. כולל מזהים של תוויות משתמש ותוויות מערכת רגילות, מוגבל ל-INBOX,‏ SPAM,‏ TRASH,‏ UNREAD,‏ STARRED,‏ IMPORTANT,‏ SENT,‏ DRAFT,‏ CHAT.

AttachmentMetadata

ייצוג ב-JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
שדות
id

string

פלט בלבד. המזהה של הקובץ המצורף.
mimeType

string

סוג ה-MIME של הקובץ המצורף.
filename

string

שם הקובץ המצורף.

הערות על כלים

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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