MCP Tools Reference: gmailmcp.googleapis.com

ابزار: create_draft

یک ایمیل پیش‌نویس جدید در حساب جیمیل کاربر احراز هویت‌شده ایجاد می‌کند.

این ابزار آدرس‌های گیرنده، موضوع و محتوای اصلی ایمیل را به عنوان ورودی دریافت می‌کند و شناسه پیش‌نویس جیمیل ایجاد شده را برمی‌گرداند.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار create_draft MCP را نشان می‌دهد.

درخواست کرل 
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
}'

طرحواره ورودی

درخواست پیام برای CreateDraft RPC.

درخواست ایجاد پیش‌نویس

نمایش 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

فهرست آدرس‌های ایمیل گیرنده «Cc» که از سربرگ‌ها استخراج شده‌اند.

bccRecipients[]

string

فهرست آدرس‌های ایمیل گیرنده «Bcc» که از سربرگ‌ها استخراج شده‌اند.

plaintextBody

string

متن ساده‌ی محتوای بدنه، در صورت وجود.

date

string

تاریخ پیش‌نویس در قالب ISO 8601 (YYYY-MM-DD).

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ❌ | راهنمایی فقط خواندنی: ❌ | راهنمایی جهان باز: ❌