MCP Tools Reference: gmailmcp.googleapis.com

ابزار: get_thread

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

پارامتر اختیاری messageFormat فرمت پیام‌های برگشتی را کنترل می‌کند. به طور پیش‌فرض (یا با FULL_CONTENT )، محتوای کامل پیام‌ها را برمی‌گرداند. MINIMAL برای شامل کردن فقط موضوع و قطعه کد (به استثنای بدنه) استفاده کنید. از METADATA_ONLY برای شامل کردن فقط فراداده‌های اولیه (شناسه پیام، شناسه رشته، برچسب‌ها، مهر زمانی و تخمین اندازه) استفاده کنید.

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

درخواست کرل 
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": "get_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

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

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

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

string

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

messageFormat

enum ( MessageFormat )

اختیاری. قالب پیام‌های برگشتی درون رشته را مشخص می‌کند. پیش‌فرض FULL_CONTENT است. توجه: قالب MINIMAL، id، snippet، subject، from، to، cc، date، labelIds را برمی‌گرداند. قالب METADATA_ONLY، id، from، to، cc، date، labelIds را برمی‌گرداند. FULL_CONTENT، id، snippet، subject، from، to، cc، date، labelIds، attachmentIds، plaintextBody، htmlBody، attachments را برمی‌گرداند.

قالب پیام

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

انوم‌ها
MESSAGE_FORMAT_UNSPECIFIED مقدار پیش‌فرض FULL_CONTENT است.
MINIMAL قطعه‌های پیام و سرصفحه‌های کلیدی (موضوع، از، به، رونوشت، تاریخ) را برمی‌گرداند.
FULL_CONTENT تمام اطلاعات موجود در "MINIMAL" به علاوه‌ی محتوای کامل بدنه‌ی هر پیام را برمی‌گرداند.
METADATA_ONLY فقط فراداده: شامل نام فایل‌های موضوع، قطعه کد، بدنه و پیوست نمی‌شود.

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

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

موضوع

نمایش 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,
  "attachmentIds": [
    string
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    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 باشد.

attachmentIds[]

string

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

htmlBody

string

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

attachments[]

object ( AttachmentMetadata )

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

labelIds[]

string

شناسه‌های برچسب‌های پیوست‌شده به پیام. شامل شناسه‌های برچسب‌های کاربر و برچسب‌های استاندارد سیستم محدود به INBOX ، SPAM ، TRASH ، UNREAD ، STARRED ، IMPORTANT ، SENT ، DRAFT ، CHAT .

پیوستفراداده

نمایش JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
فیلدها
id

string

فقط خروجی. شناسه پیوست.

mimeType

string

نوع MIME پیوست.

filename

string

نام فایل پیوست.

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

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

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

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