MCP Tools Reference: gmailmcp.googleapis.com

الأداة: create_draft

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

تتلقّى هذه الأداة عناوين المستلِمين والموضوع ومحتوى الرسالة كمدخلات. تعرض هذه الطريقة رقم تعريف مسودة Gmail التي تم إنشاؤها.

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

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

مخطط الإدخال

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

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)

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

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