MCP Tools Reference: gmailmcp.googleapis.com

כלי: label_thread

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

אם אתם לא בטוחים מה מזהה השרשור, כדאי להשתמש קודם בכלי search_threads.

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

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ label_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": "label_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

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

LabelThreadRequest

ייצוג ב-JSON 
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
שדות
threadId

string

חובה. המזהה הייחודי של השרשור שרוצים להוסיף לו תוויות.
labelIds[]

string

חובה. המזהים הייחודיים של התוויות שרוצים להוסיף. יכול להיות מזהה של תווית מערכת (למשל, 'INBOX',‏ 'STARRED',‏ 'UNREAD',‏ 'IMPORTANT') או מזהה של תווית שהוגדרה על ידי המשתמש. הכלי מקבל את הערך label_ids ולא שמות של תוויות. משתמשים בכלי list_labels כדי לקבל את מזהה התווית המתאים לשם התצוגה של תוויות שהוגדרו על ידי המשתמש.

סכימת הפלט

הודעת התגובה לקריאה לשירות מרוחק (RPC) של LabelThread.

הערות על כלים

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

היקפי הרשאות

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

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