MCP Tools Reference: gmailmcp.googleapis.com

כלי: unlabel_message

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

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

סכימת הקלט

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

UnlabelMessageRequest

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

string

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

string

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

סכימת הפלט

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

הערות על כלים

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

היקפי הרשאות

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

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