MCP Tools Reference: gmailmcp.googleapis.com

ابزار: get_thread

یک رشته ایمیل خاص را از حساب Gmail کاربر احراز هویت شده، شامل لیستی از پیام‌های آن، بازیابی می‌کند.

مثال زیر نحوه استفاده از curl برای فراخوانی ابزار get_thread 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": "get_thread",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

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

درخواست دریافت نخ

نمایش JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
فیلدها
threadId

string

الزامی. شناسه‌ی منحصر به فردِ نخی که قرار است واکشی شود.

messageFormat

enum ( MessageFormat )

اختیاری. قالب پیام‌های برگشتی درون رشته را مشخص می‌کند. مقدار پیش‌فرض FULL_CONTENT است.

طرحواره خروجی

تاپیکی که شامل لیستی از پیام‌ها است.

موضوع

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

آدرس‌های ایمیل گیرنده‌ی CC.

date

string

تاریخ پیام در قالب ISO 8601 (YYYY-MM-DD).

plaintextBody

string

محتوای کامل بدنه، فقط در صورتی پر می‌شود که MessageFormat برابر با FULL_CONTENT باشد.

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

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