MCP Tools Reference: gmailmcp.googleapis.com

الأداة: create_draft

تُنشئ هذه الطريقة مسودة رسالة إلكترونية جديدة في حساب Gmail الخاص بالمستخدم الذي تمّت المصادقة عليه.

تتلقّى هذه الأداة عناوين المستلِمين والموضوع ومحتوى الرسالة كمدخلات. إذا تم إنشاء المسودّة كردّ على رسالة حالية، يجب تمرير معرّف الرسالة الأصلية إلى الأداة في الحقل replyToMessageId.

تعرض هذه الطريقة المعرّف الفريد (id) للرسالة المسودّة فقط.

قيد: لا تتوفّر حاليًا إمكانية إنشاء مسودات تتضمّن مرفقات.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة create_draft MCP.

طلب 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
}'

مخطط الإدخال

رسالة الطلب لإجراء CreateDraft RPC.

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)

اختياريّ. المرفقات التي يجب تضمينها في الرسالة الإلكترونية يجب ألا يتجاوز إجمالي حجم المرفقات في الرسالة 25 ميغابايت. إذا كنت بحاجة إلى إرسال ملفات أكبر من 25 ميغابايت، حمِّل الملف إلى 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 الخاص بالمسودة، إذا كان متاحًا

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌

نطاقات التفويض

يجب توفير أحد نطاقات OAuth التالية:

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