MCP Tools Reference: gmailmcp.googleapis.com

ابزار: create_draft

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

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

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

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

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

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

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

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

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

bccRecipients[]

string

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

plaintextBody

string

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

date

string

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

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

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