MCP Tools Reference: gmailmcp.googleapis.com

כלי: unlabel_thread

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

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

סכימת הקלט

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

UnlabelThreadRequest

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

string

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

string

חובה. המזהים הייחודיים של התוויות להסרה. יכול להיות מזהה של תווית מערכת (למשל, 'תיבת דואר נכנס', 'אשפה', 'ספאם', 'מסומן בכוכב', 'לא נקרא', 'חשוב') או מזהה של תווית שהוגדרה על ידי המשתמש. הכלי מקבל את הערך label_ids ולא שמות של תוויות. משתמשים בכלי list_labels כדי לקבל את מזהה התווית המתאים לשם התצוגה של תוויות שהוגדרו על ידי המשתמש.

סכימת הפלט

הודעת תגובה ל-RPC של UnlabelThread.

הערות על כלים

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

היקפי הרשאות

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

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