MCP Tools Reference: gmailmcp.googleapis.com

टूल: get_thread

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

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

कर्ल अनुरोध 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--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 के लिए अनुरोध मैसेज.

GetThreadRequest

JSON के काेड में दिखाना 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
फ़ील्ड
threadId

string

ज़रूरी है. फ़ेच किए जाने वाले थ्रेड का यूनीक आइडेंटिफ़ायर.
messageFormat

enum (MessageFormat)

ज़रूरी नहीं. इससे थ्रेड में दिखाए गए मैसेज का फ़ॉर्मैट तय होता है. डिफ़ॉल्ट रूप से, इसकी वैल्यू FULL_CONTENT होती है. ध्यान दें: अगर आपको बॉडी कॉन्टेंट या अटैचमेंट की ज़रूरत है, तो FULL_CONTENT का इस्तेमाल करें. MINIMAL का इस्तेमाल करने पर, plaintext_body और attachment_ids फ़ील्ड में जानकारी नहीं भरी जाएगी. अगर आपको यह नहीं पता कि कौनसा फ़ॉर्मैट इस्तेमाल करना है, तो FULL_CONTENT का इस्तेमाल करके डिफ़ॉल्ट व्यवहार पर भरोसा करें.

MessageFormat

थ्रेड में मौजूद मैसेज के लिए, जानकारी के लेवल को कंट्रोल करने वाला Enum.

Enums
MESSAGE_FORMAT_UNSPECIFIED डिफ़ॉल्ट रूप से, इसकी वैल्यू FULL_CONTENT होती है.
MINIMAL यह फ़ंक्शन, मैसेज के स्निपेट और मुख्य हेडर (विषय, भेजने वाला, पाने वाला, कॉपी, तारीख) दिखाता है.
FULL_CONTENT यह "MINIMAL" में मौजूद सभी जानकारी के साथ-साथ, हर मैसेज का पूरा कॉन्टेंट दिखाता है.

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

मैसेज की सूची वाला थ्रेड.

थ्रेड

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
  ]
}
फ़ील्ड
id

string

यह मैसेज का यूनीक आइडेंटिफ़ायर होता है.
snippet

string

मैसेज के मुख्य हिस्से का स्निपेट.
subject

string

हेडर से निकाला गया मैसेज का विषय:
sender

string

भेजने वाले का ईमेल पता.
toRecipients[]

string

ईमेल पाने वालों के पतों पर.
ccRecipients[]

string

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

string

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

string

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

string

सिर्फ़ आउटपुट के लिए. अटैचमेंट आईडी. ये आईडी सिर्फ़ तब दिखते हैं, जब MessageFormat FULL_CONTENT पर सेट हो.

टूल एनोटेशन

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