MCP Tools Reference: gmailmcp.googleapis.com

כלי: create_draft

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

הכלי הזה מקבל כקלט כתובות של נמענים, נושא ותוכן ההודעה. אם הטיוטה נוצרה כתשובה להודעה קיימת, צריך להעביר את המזהה של ההודעה המקורית לכלי בשדה replyToMessageId.

הפונקציה מחזירה רק את המזהה הייחודי (id) של הודעת הטיוטה.

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

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

בקשת 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": "create_draft",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

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

CreateDraftRequest

ייצוג ב-JSON 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string,
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
שדות
to[]

string

אופציונלי. הנמענים העיקריים של טיוטת האימייל. כל מחרוזת חייבת להיות כתובת אימייל תקינה (למשל, user@example.com). הכלי הזה לא תומך בפורמט 'שם email@example.com'.
cc[]

string

אופציונלי. הנמענים בשדה 'עותק' של טיוטת האימייל. כל מחרוזת חייבת להיות כתובת אימייל תקינה (למשל, user@example.com). הכלי הזה לא תומך בפורמט 'שם email@example.com'.
bcc[]

string

אופציונלי. הנמענים בשדה 'עותק מוסתר' של טיוטת האימייל. כל מחרוזת חייבת להיות כתובת אימייל תקינה (למשל, user@example.com). הכלי הזה לא תומך בפורמט 'שם email@example.com'.
subject

string

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

string

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

string

תוכן ה-HTML של טיוטת האימייל. אם מספקים את הערך הזה, הוא ישמש כגרסת הטקסט העשיר של האימייל.
replyToMessageId

string

אופציונלי. המזהה של ההודעה שצריך להשיב לה. אם מציינים מזהה, הוא ישמש כמזהה ההודעה של טיוטת האימייל שצריך להשיב לה, והתווים body ו-html_body יצורפו לגוף ההודעה המקורית.
attachments[]

object (Attachment)

אופציונלי. הקבצים המצורפים שצריך לכלול באימייל. הגודל הכולל של הקבצים המצורפים בהודעה לא יכול לחרוג מ-25MB. אם אתם צריכים לשלוח קבצים גדולים מ-25MB, אתם צריכים קודם להעלות את הקובץ ל-Drive ואז להוסיף את הקישור ל-Drive לגוף ההודעה או ל-html_body.

קובץ מצורף

ייצוג ב-JSON 
{
  "id": string,
  "filename": string,
  "mimeType": string,
  "content": string,
  "inline": boolean
}
שדות
id

string

אופציונלי. פלט בלבד. אם יש קובץ מצורף חיצוני, הערך מכיל את המזהה שלו שאפשר לאחזר באמצעות בקשת GetMessageAttachment נפרדת.
filename

string

אופציונלי. שם הקובץ לצירוף, לדוגמה, invoice.pdf. בקבצים מצורפים מוטבעים, הערך הזה משמש ליצירת Content-ID. בקבצים מצורפים רגילים, שם הקובץ משמש לציון שם הקובץ ללקוחות אימייל. אם לא מציינים שם, יכול להיות שהקובץ המצורף יתקבל ללא שם.
mimeType

string

אופציונלי. בשדה שמייצג סוג תוכן או סוג מדיה צריך להשתמש בסוג MIME של IANA, ‏ https://www.iana.org/assignments/media-types/media-types.xhtml. אם לא מציינים ערך, ברירת המחדל היא application/octet-stream.
content

string (bytes format)

חובה. התוכן של הקובץ המצורף בקידוד Base64.

מחרוזת בקידוד Base64.
inline

boolean

אופציונלי. אם הערך הוא true, הטיפול בקובץ המצורף הוא כקובץ מוטבע. קובץ מצורף מוטבע הוא תוכן שמיועד להצגה בגוף של אימייל בפורמט HTML, ולא להופיע כקובץ נפרד להורדה. אם הערך הוא False או שהמאפיין לא מופיע, ברירת המחדל היא False והמערכת מתייחסת אליו כאל קובץ מצורף רגיל.

סכימת הפלט

פרטים של טיוטה.

טיוטה

ייצוג ב-JSON 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string,
  "htmlBody": string
}
שדות
id

string

המזהה הייחודי של משאב הטיוטה.
subject

string

שורת הנושא של הטיוטה.
threadId

string

המזהה של השרשור שהטיוטה שייכת אליו.
toRecipients[]

string

רשימה של כתובות אימייל של נמענים בשדה 'אל' שחולצו מהכותרות.
ccRecipients[]

string

רשימה של כתובות אימייל של נמענים בשדה 'עותק' שחולצו מהכותרות.
bccRecipients[]

string

רשימה של כתובות אימייל של נמענים בשדה 'עותק מוסתר' שחולצו מהכותרות.
plaintextBody

string

תוכן הגוף בטקסט פשוט, אם זמין.
date

string

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

string

תוכן ה-HTML של גוף הטיוטה, אם זמין.

הערות על כלים

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

היקפי הרשאות

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

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