MCP Tools Reference: gmailmcp.googleapis.com

כלי: create_draft

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

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

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

בקשת Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--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
}
שדות
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 יצורפו לגוף ההודעה המקורית.

סכימת פלט

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

טיוטה

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

הערות על כלי

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