MCP Tools Reference: gmailmcp.googleapis.com

כלי: create_draft

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

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

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

בקשת Curl
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--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 MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

סכימת קלט

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

CreateDraftRequest

ייצוג JSON
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": 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 של טיוטת האימייל. אם מספקים את הגרסה הזו, היא תשמש כגרסת הטקסט העשיר של האימייל.

סכימת פלט

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

טיוטה

ייצוג 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).

הערות על כלי

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