MCP Tools Reference: gmailmcp.googleapis.com

כלי: get_thread

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

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

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

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

סכימת הקלט

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

GetThreadRequest

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

string

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

enum (MessageFormat)

אופציונלי. מציין את הפורמט של ההודעות שמוחזרות בשרשור. ברירת המחדל היא FULL_CONTENT. הערה: בפורמט MINIMAL מוחזרים הערכים id, ‏ snippet, ‏ subject, ‏ from, ‏ to, ‏ cc, ‏ date, ‏ labelIds. פורמט METADATA_ONLY מחזיר את הערכים id, ‏ from, ‏ to, ‏ cc, ‏ date, ‏ labelIds. ‫FULL_CONTENT מחזירה את הערכים id, ‏ snippet, ‏ subject, ‏ from, ‏ to, ‏ cc, ‏ date, ‏ labelIds, ‏ attachmentIds, ‏ plaintextBody, ‏ htmlBody, ‏ attachments.

MessageFormat

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

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

סכימת הפלט

שרשור שמכיל רשימה של הודעות.

חוט תפירה

ייצוג ב-JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
שדות
id

string

המזהה הייחודי של השרשור.
messages[]

object (Message)

רשימת ההודעות בשרשור, בסדר כרונולוגי.

שליחת הודעה

ייצוג ב-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