MCP Tools Reference: gmailmcp.googleapis.com

ابزار: search_threads

رشته‌های ایمیل از حساب Gmail کاربر احراز هویت‌شده را فهرست می‌کند.

این ابزار می‌تواند رشته‌ها را بر اساس یک رشته پرس‌وجو فیلتر کند و از صفحه‌بندی پشتیبانی می‌کند. این ابزار لیستی از رشته‌ها، شامل شناسه‌های آنها و پیام‌های مرتبط را برمی‌گرداند. هر پیام مرتبط شامل جزئیاتی مانند بخشی از متن پیام، موضوع، فرستنده، گیرندگان و غیره است. توجه داشته باشید که متن کامل پیام توسط این ابزار برگردانده نمی‌شود؛ در صورت نیاز از ابزار 'get_thread' با شناسه رشته برای دریافت متن کامل پیام استفاده کنید.

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

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

درخواست پیام برای RPC مربوط به SearchThreads.

جستجوموضوعاتدرخواست

نمایش JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
فیلدها

فیلد یونیون _page_size .

_page_size می‌تواند فقط یکی از موارد زیر باشد:

pageSize

integer

اختیاری. حداکثر تعداد نخ‌هایی که باید برگردانده شوند. اگر مشخص نشود، پیش‌فرض 20 است. حداکثر مقدار مجاز 50 است.

فیلد یونیون _page_token .

_page_token فقط می‌تواند یکی از موارد زیر باشد:

pageToken

string

اختیاری. توکن صفحه برای بازیابی یک صفحه خاص از نتایج در لیست. برای دریافت صفحه اول، آن را خالی بگذارید.

فیلد یونیون _query .

_query فقط می‌تواند یکی از موارد زیر باشد:

query

string

اختیاری. یک رشته پرس‌وجو برای فیلتر کردن رشته‌ها، با استفاده از همان قالب نوار جستجوی جیمیل. در صورت حذف، همه رشته‌ها (به استثنای هرزنامه و زباله به طور پیش‌فرض) فهرست می‌شوند. عملگرهای کلیدی: from: - پیام‌هایی از یک فرستنده خاص به: - پیام‌های ارسال شده به یک گیرنده خاص. موضوع: - پیام‌هایی با کلمات خاص در موضوع. - پیام‌هایی که حاوی کلمات خاص در بدنه یا موضوع هستند. is:unread - پیام‌های خوانده نشده. is:starred - پیام‌های ستاره‌دار. has:attachment - پیام‌های دارای پیوست. after:YYYY/MM/DD - پیام‌های ارسال شده پس از یک تاریخ. before:YYYY/MM/DD - پیام‌های ارسال شده قبل از یک تاریخ. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

فیلد یونیون _include_trash .

_include_trash ‎‏ فقط می‌تواند یکی از موارد زیر باشد:

includeTrash

boolean

اختیاری. پیش‌نویس‌های TRASH را در نتایج لحاظ کنید. پیش‌فرض‌ها false است.

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

پیام پاسخ برای RPC مربوط به SearchThreads.

جستجوموضوعاتپاسخ

نمایش JSON 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
فیلدها
threads[]

object ( Thread )

فهرست خلاصه موضوعات.

nextPageToken

string

توکنی که می‌تواند در فراخوانی بعدی برای بازیابی صفحه بعدی رشته‌ها استفاده شود. فقط در صورتی ارائه می‌شود که نتایج بیشتری وجود داشته باشد.

موضوع

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

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

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