MCP Tools Reference: gmailmcp.googleapis.com

الأداة: get_thread

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

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة get_thread 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": "get_thread",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

طلب رسالة لإجراء GetThread عن بُعد

GetThreadRequest

تمثيل JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
الحقول
threadId

string

الحقل مطلوب. المعرّف الفريد لسلسلة المحادثات المطلوب استرجاعها.
messageFormat

enum (MessageFormat)

اختياريّ. تحدّد هذه السمة تنسيق الرسائل المعروضة ضمن سلسلة المحادثات. القيمة التلقائية هي FULL_CONTENT.

مخطط النتائج

سلسلة محادثات تحتوي على قائمة بالرسائل

Thread

تمثيل JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
الحقول
id

string

المعرّف الفريد لسلسلة المحادثات.
messages[]

object (Message)

قائمة بالرسائل في سلسلة المحادثات، مرتبة حسب التسلسل الزمني

رسالة

تمثيل JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string
}
الحقول
id

string

المعرّف الفريد للرسالة.
snippet

string

مقتطف من نص الرسالة
subject

string

موضوع الرسالة المستخرَج من العناوين:
sender

string

عنوان البريد الإلكتروني للمُرسِل
toRecipients[]

string

إلى عناوين البريد الإلكتروني للمستلِمين
ccRecipients[]

string

عناوين البريد الإلكتروني للمستلِمين في الحقل "نسخة إلى"
date

string

تاريخ الرسالة بتنسيق ISO 8601 (YYYY-MM-DD)
plaintextBody

string

محتوى النص الكامل، ويتم ملؤه فقط إذا كانت قيمة MessageFormat هي FULL_CONTENT.

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

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