MCP Tools Reference: gmailmcp.googleapis.com

כלי: search_threads

רשימה של שרשורי אימייל מחשבון Gmail של המשתמש המאומת.

הכלי הזה יכול לסנן שרשורים על סמך מחרוזת שאילתה, והוא תומך בחלוקה לעמודים. הפונקציה מחזירה רשימה של שרשורים, כולל המזהים שלהם וההודעות שקשורות אליהם. כל הודעה קשורה מכילה פרטים כמו קטע מגוף ההודעה, הנושא, השולח, הנמענים וכו'. שימו לב שהכלי הזה לא מחזיר את גוף ההודעה המלא. אם אתם צריכים את גוף ההודעה המלא, אתם יכולים להשתמש בכלי get_thread עם מזהה השרשור.

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

בקשת Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_threads",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת קלט

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

SearchThreadsRequest

ייצוג JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
שדות

שדה איחוד _page_size.

הערך _page_size יכול להיות רק אחד מהבאים:
pageSize

integer

אופציונלי. מספר השרשורים המקסימלי שיוחזרו. אם לא מציינים ערך, ברירת המחדל היא 20. הערך המקסימלי המותר הוא 50.

שדה איחוד _page_token.

הערך _page_token יכול להיות רק אחד מהבאים:
pageToken

string

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

שדה איחוד _query.

הערך _query יכול להיות רק אחד מהבאים:
query

string

אופציונלי. מחרוזת שאילתה לסינון השרשורים, בפורמט זהה לזה של סרגל החיפוש ב-Gmail. אם לא מציינים ערך, מוצגים כל השרשורים (לא כולל ספאם ואשפה כברירת מחדל). מילות מפתח: from: – הודעות משולח ספציפי. to: – הודעות שנשלחו לנמען ספציפי. subject: – הודעות עם מילים ספציפיות בנושא. - הודעות שמכילות מילים ספציפיות בגוף ההודעה או בנושא. is:unread - הודעות שלא נקראו. is:starred - הודעות שמסומנות בכוכב. has:attachment - הודעות עם קבצים מצורפים. after:YYYY/MM/DD – הודעות שנשלחו אחרי תאריך מסוים. before:YYYY/MM/DD – הודעות שנשלחו לפני תאריך מסוים. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

שדה איחוד _include_trash.

הערך _include_trash יכול להיות רק אחד מהבאים:
includeTrash

boolean

אופציונלי. הכללת טיוטות מתיקיית האשפה בתוצאות. ברירת המחדל היא False.

סכימת פלט

הודעת התגובה של RPC מסוג SearchThreads.

SearchThreadsResponse

ייצוג JSON 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
שדות
threads[]

object (Thread)

רשימה של סיכומי השרשורים.
nextPageToken

string

טוקן שאפשר להשתמש בו בקריאה הבאה כדי לאחזר את הדף הבא של השרשורים. האפשרות הזו מוצגת רק אם יש עוד תוצאות.

חוט תפירה

ייצוג 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
}
שדות
id

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

הערות על כלי

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