MCP Tools Reference: gmailmcp.googleapis.com

टूल: list_labels

यह टूल, पुष्टि किए गए उपयोगकर्ता के Gmail खाते में मौजूद, उपयोगकर्ता के तय किए गए सभी लेबल की सूची दिखाता है. label_thread, unlabel_thread, label_message या unlabel_message को कॉल करने से पहले, उपयोगकर्ता के लेबल का id पता करने के लिए, इस टूल का इस्तेमाल करें. यह टूल, सिस्टम लेबल नहीं दिखाता. हालांकि, इन्हें इनके जाने-माने आईडी के साथ इस्तेमाल किया जा सकता है: 'INBOX', 'TRASH', 'SPAM', 'STARRED', 'UNREAD', 'IMPORTANT', 'CHAT', 'DRAFT', 'SENT'.

यहां दिए गए उदाहरण में, list_labels 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": "list_labels",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

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

ListLabelsRequest

JSON के काेड में दिखाना 
{

  "pageSize": integer

  "pageToken": string
}
फ़ील्ड

यूनियन फ़ील्ड _page_size.

_page_size के लिए, इनमें से सिर्फ़ एक वैल्यू चुनी जा सकती है:
pageSize

integer

ज़रूरी नहीं. लेबल की ज़्यादा से ज़्यादा संख्या, जिन्हें वापस लाया जा सकता है.

यूनियन फ़ील्ड _page_token.

_page_token के लिए, इनमें से सिर्फ़ एक वैल्यू चुनी जा सकती है:
pageToken

string

ज़रूरी नहीं. सूची में नतीजों का कोई खास पेज वापस पाने के लिए, पेज टोकन.

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

ListLabels RPC के लिए जवाब का मैसेज.

ListLabelsResponse

JSON के काेड में दिखाना 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
labels[]

object (Label)

उपयोगकर्ता के खाते में मौजूद, उपयोगकर्ता के लेबल की सूची.
nextPageToken

string

सूची में नतीजों का अगला पेज वापस पाने के लिए टोकन.

लेबल

JSON के काेड में दिखाना 
{
  "labelId": string,
  "name": string,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
फ़ील्ड
labelId

string

लेबल का यूनीक आइडेंटिफ़ायर.
name

string

लेबल का ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सके.
color

object (LabelColor)

ज़रूरी नहीं. लेबल का रंग.

यूनियन फ़ील्ड _threads_total.

_threads_total के लिए, इनमें से सिर्फ़ एक वैल्यू चुनी जा सकती है:
threadsTotal

integer

लेबल के तहत मौजूद थ्रेड की कुल संख्या.

यूनियन फ़ील्ड _threads_unread.

_threads_unread के लिए, इनमें से सिर्फ़ एक वैल्यू चुनी जा सकती है:
threadsUnread

integer

लेबल के तहत मौजूद, नहीं पढ़े गए थ्रेड की संख्या.

LabelColor

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

string

लेबल के टेक्स्ट का रंग, जिसे हेक्स स्ट्रिंग के तौर पर दिखाया जाता है. जैसे, "#000000". रंग की सिर्फ़ इन पहले से तय की गई वैल्यू का इस्तेमाल किया जा सकता है: #000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, #fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c, #464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765
backgroundColor

string

लेबल का बैकग्राउंड कलर, जिसे हेक्स स्ट्रिंग के तौर पर दिखाया जाता है. जैसे, "#ffffff". रंग की सिर्फ़ इन पहले से तय की गई वैल्यू का इस्तेमाल किया जा सकता है: #000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, #fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c, #464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765

टूल के एनोटेशन

डेटा मिटाने की जानकारी: ❌ | एक ही कार्रवाई को बार-बार करने की जानकारी: ✅ | सिर्फ़ पढ़ने की जानकारी: ✅ | ओपन वर्ल्ड की जानकारी: ❌

अनुमति पाने के लिंक

इसके लिए, 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.labels
  • https://www.googleapis.com/auth/gmail.metadata