MCP Tools Reference: gmailmcp.googleapis.com

टूल: get_thread

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

messageFormat पैरामीटर, वापस लाए गए मैसेज के फ़ॉर्मैट को कंट्रोल करता है. यह पैरामीटर ज़रूरी नहीं है. डिफ़ॉल्ट रूप से (या FULL_CONTENT के साथ), यह मैसेज का पूरा कॉन्टेंट दिखाता है. सिर्फ़ विषय और स्निपेट (मुख्य हिस्सा छोड़कर) शामिल करने के लिए, MINIMAL का इस्तेमाल करें. सिर्फ़ बुनियादी मेटाडेटा (मैसेज आईडी, थ्रेड आईडी, लेबल, टाइमस्टैंप, और साइज़ का अनुमान) शामिल करने के लिए, METADATA_ONLY का इस्तेमाल करें.

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

Curl का अनुरोध 
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 के लिए अनुरोध मैसेज.

GetThreadRequest

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

string

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

enum (MessageFormat)

ज़रूरी नहीं. इससे, थ्रेड में वापस लाए गए मैसेज का फ़ॉर्मैट तय होता है. डिफ़ॉल्ट रूप से, यह FULL_CONTENT पर सेट होता है. ध्यान दें: MINIMAL फ़ॉर्मैट में आईडी, स्निपेट, विषय, भेजने वाला, पाने वाला, सीसी, तारीख, और labelIds की जानकारी मिलती है. METADATA_ONLY फ़ॉर्मैट में आईडी, भेजने वाला, पाने वाला, सीसी, तारीख, और labelIds की जानकारी मिलती है. FULL_CONTENT में आईडी, स्निपेट, विषय, भेजने वाला, पाने वाला, सीसी, तारीख, labelIds, attachmentIds, plaintextBody, htmlBody, और अटैचमेंट की जानकारी मिलती है.

MessageFormat

थ्रेड में शामिल मैसेज की जानकारी के लेवल को कंट्रोल करने के लिए, Enum का इस्तेमाल करें.

Enums
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

सीसी में शामिल लोगों के ईमेल पते.
date

string

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

string

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

string

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

string

ईमेल का एचटीएमएल कॉन्टेंट. यह सिर्फ़ तब दिखता है, जब MessageFormat को FULL_CONTENT पर सेट किया गया हो.
attachments[]

object (AttachmentMetadata)

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

string

मैसेज से जुड़े लेबल के आईडी. इसमें, उपयोगकर्ता के लेबल और स्टैंडर्ड सिस्टम लेबल के आईडी शामिल होते हैं. हालांकि, ये आईडी सिर्फ़ INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT तक सीमित होते हैं.

AttachmentMetadata

JSON के काेड में दिखाना 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
फ़ील्ड
id

string

सिर्फ़ आउटपुट के लिए. अटैचमेंट का आईडी.
mimeType

string

अटैचमेंट का एमआईएमई टाइप.
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