MCP Reference: gmailmcp.googleapis.com

שרת Model Context Protocol‏ (MCP) פועל כשרת proxy בין שירות חיצוני שמספק הקשר, נתונים או יכולות למודל שפה גדול (LLM) או לאפליקציית AI. שרתי MCP מחברים אפליקציות AI למערכות חיצוניות כמו מסדי נתונים ושירותי אינטרנט, ומתרגמים את התשובות שלהם לפורמט שאפליקציית ה-AI יכולה להבין.

כלי MCP

כלי MCP הוא פונקציה או יכולת הפעלה ששרת MCP חושף למודל שפה גדול (LLM) או לאפליקציית AI כדי לבצע פעולה בעולם האמיתי.

לשרת ה-MCP‏ gmailmcp.googleapis.com יש את הכלים הבאים:

כלי MCP
create_draft

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

הכלי הזה מקבל כקלט כתובות של נמענים, נושא ותוכן ההודעה. הפונקציה מחזירה את המזהה של הטיוטה שנוצרה ב-Gmail.
list_drafts

הפונקציה מחזירה רשימה של טיוטות אימייל מחשבון Gmail של המשתמש המאומת.

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

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

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

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

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

אם אתם לא בטוחים מה המזהה של תווית משתמש, כדאי להשתמש קודם בכלי list_labels כדי לגלות את התוויות הזמינות ואת המזהים שלהן.
unlabel_thread הסרת תוויות מכל השרשור בחשבון Gmail של המשתמש המאומת. אם אתם לא בטוחים מה מזהה השרשור, כדאי להשתמש קודם בכלי search_threads. אם אתם לא בטוחים מה המזהה של תווית משתמש, כדאי להשתמש קודם בכלי list_labels.
list_labels רשימה של כל התוויות שהוגדרו על ידי המשתמש וזמינות בחשבון Gmail של המשתמש המאומת. אפשר להשתמש בכלי הזה כדי לגלות את id של תווית משתמש לפני שקוראים לפונקציות label_thread, unlabel_thread, label_message או unlabel_message. הכלי לא מחזיר תוויות מערכת, אבל אפשר להשתמש בהן עם המזהים המוכרים שלהן: INBOX,‏ TRASH,‏ SPAM,‏ STARRED,‏ UNREAD,‏ IMPORTANT,‏ CHAT,‏ DRAFT,‏ SENT.
label_message

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

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

קבלת מפרטים של כלי ה-MCP

כדי לקבל את המפרטים של כלי ה-MCP לכל הכלים בשרת MCP, משתמשים בשיטה tools/list. בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להציג רשימה של כל הכלים והמפרטים שלהם שזמינים כרגע בשרת ה-MCP.

בקשת Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'