MCP Tools Reference: gmailmcp.googleapis.com

टूल: search_threads

इस तरीके से, पुष्टि किए गए उपयोगकर्ता के Gmail खाते से ईमेल थ्रेड की सूची मिलती है.

यह टूल, क्वेरी स्ट्रिंग के आधार पर थ्रेड को फ़िल्टर कर सकता है. साथ ही, इसमें पेज नंबर के हिसाब से नतीजे दिखाने की सुविधा भी काम करती है. यह थ्रेड की सूची दिखाता है. इसमें थ्रेड के आईडी और उनसे जुड़े मैसेज शामिल होते हैं. हर मिलते-जुलते मैसेज में, मैसेज के मुख्य हिस्से का स्निपेट, विषय, भेजने वाला, पाने वाले वगैरह की जानकारी होती है. ध्यान दें कि यह टूल, मैसेज के पूरे मुख्य हिस्से को नहीं दिखाता है. अगर आपको मैसेज का पूरा मुख्य हिस्सा चाहिए, तो थ्रेड आईडी के साथ 'get_thread' टूल का इस्तेमाल करें.

यहां दिए गए सैंपल में, curl का इस्तेमाल करके search_threads एमसीपी टूल को चालू करने का तरीका बताया गया है.

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": "search_threads",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

SearchThreads RPC के लिए अनुरोध मैसेज.

SearchThreadsRequest

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

ज़रूरी नहीं. थ्रेड को फ़िल्टर करने के लिए क्वेरी स्ट्रिंग. इसका फ़ॉर्मैट, Gmail के खोज बार जैसा ही होता है. अगर इसे शामिल नहीं किया जाता है, तो सभी थ्रेड (डिफ़ॉल्ट रूप से स्पैम और ट्रैश को छोड़कर) दिखती हैं. मुख्य ऑपरेटर: from: - किसी व्यक्ति से मिले मैसेज. to: - किसी व्यक्ति को भेजे गए मैसेज. विषय: - ऐसे मैसेज जिनके विषय में कुछ खास शब्द शामिल हैं. - ऐसे मैसेज जिनमें मुख्य हिस्से या विषय में कुछ खास शब्द शामिल हों. 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

ज़रूरी नहीं. नतीजों में, ट्रैश में मौजूद ड्राफ़्ट शामिल करें. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होती है.

आउटपुट स्कीमा

SearchThreads आरपीसी के लिए जवाब का मैसेज.

SearchThreadsResponse

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

कॉपी पाने वाले लोगों के ईमेल पते.
date

string

आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DD) में मैसेज की तारीख.
plaintextBody

string

पूरे मैसेज का कॉन्टेंट. यह सिर्फ़ तब दिखता है, जब MessageFormat FULL_CONTENT पर सेट हो.

टूल एनोटेशन

बदलाव करने से जुड़ी जानकारी: ❌ | एक ही बार लागू होने से जुड़ी जानकारी: ✅ | सिर्फ़ पढ़ने से जुड़ी जानकारी: ✅ | ओपन वर्ल्ड से जुड़ी जानकारी: ❌