MCP Tools Reference: gmailmcp.googleapis.com

টুল: search_threads

যাচাইকৃত ব্যবহারকারীর Gmail অ্যাকাউন্ট থেকে ইমেল থ্রেডের তালিকা দেখায়।

এই টুল কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে থ্রেড ফিল্টার করতে পারে এবং পৃষ্ঠা সংখ্যা দেখায়। এটি থ্রেডের আইডি ও সম্পর্কিত মেসেজ সহ থ্রেডের তালিকা দেখায়। প্রতিটি সম্পর্কিত মেসেজে মেসেজের বডির স্নিপেট, বিষয়, প্রেরক, প্রাপক ইত্যাদির মতো বিবরণ থাকে। view প্যারামিটারটি সম্পর্কিত মেসেজে কোন কোন ফিল্ড পূরণ করা হবে তা নিয়ন্ত্রণ করে। ডিফল্ট হিসেবে (অথবা THREAD_VIEW_MINIMAL-এর সাথে), এতে বিষয় ও স্নিপেট অন্তর্ভুক্ত থাকে। বিষয় ও স্নিপেট বাদ দিতে THREAD_VIEW_METADATA_ONLY ব্যবহার করুন। মনে রাখবেন যে এই টুল সম্পূর্ণ মেসেজের বিষয়বস্তু ফিরিয়ে দেয় না; প্রয়োজন হলে সম্পূর্ণ মেসেজের বিষয়বস্তু নিয়ে আসার জন্য থ্রেড আইডি সহ 'get_thread' টুল ব্যবহার করুন। বাদ দেওয়া মাপকাঠি সহ থ্রেড এখনও ফলাফলে দেখা যেতে পারে। এটি ঘটে কারণ Gmail প্রথমে ম্যাচিং মেসেজ শনাক্ত করে। যেমন, আপনি -is:starred সার্চ করলে, Gmail এমন একটি সম্পূর্ণ থ্রেড খুঁজে পাবে যাতে অন্তত একটি স্টার না দেওয়া মেসেজ আছে, এমনকি সেই একই কথোপকথনের অন্যান্য ইমেলে স্টার দেওয়া থাকলেও।

নিচের স্যাম্পেল থেকে বোঝা যায় যে search_threads 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": "search_threads",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

ইনপুট স্কিমা

SearchThreads RPC-এর জন্য অনুরোধের মেসেজ।

SearchThreadsRequest

JSON উপস্থাপনা
{
  "pageSize": integer,
  "pageToken": string,
  "query": string,
  "includeTrash": boolean,
  "view": enum (ThreadView)
}
ফিল্ড

ইউনিয়ন ফিল্ড _page_size।

_page_size শুধুমাত্র নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

pageSize

integer

ঐচ্ছিক। ফেরত দেওয়ার জন্য থ্রেডের সর্বাধিক সংখ্যা। নির্দিষ্ট করা না থাকলে, ডিফল্ট হল ২০। সর্বাধিক অনুমোদিত মান হল ৫০।

ইউনিয়ন ফিল্ড _page_token।

_page_token শুধুমাত্র নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

pageToken

string

ঐচ্ছিক। তালিকায় ফলাফলের নির্দিষ্ট পৃষ্ঠা ফিরিয়ে আনতে পৃষ্ঠা টোকেন। প্রথম পৃষ্ঠাটি আনার জন্য জায়গাটি খালি রাখুন। এটি মূলত পেজিনেশনের জন্য ব্যবহার করা হয় যাতে আগের SearchThreads কলটি যেখানে শেষ হয়েছিল সেখান থেকে ফলাফল আনা চালিয়ে যাওয়া যায়, বিশেষ করে যখন কোয়েরির সাথে মিলে যাওয়া থ্রেডের সংখ্যা page_size সীমা ছাড়িয়ে যায়।

ইউনিয়ন ফিল্ড _query।

_query শুধুমাত্র নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

query

string

ঐচ্ছিক। থ্রেড ফিল্টার করার জন্য একটি কোয়েরি স্ট্রিং। এই টুল ব্যবহার করতে হলে, ন্যাচারাল ল্যাঙ্গুয়েজ কোয়েরি অবশ্যই Gmail সিনট্যাক্স কোয়েরিতে আগে থেকে কনভার্ট করা থাকতে হবে। বাদ দেওয়া হলে, সব থ্রেড (ডিফল্ট হিসেবে স্প্যাম ও ট্র্যাশ বাদ দিয়ে) তালিকাভুক্ত করা হয়।

বিভাগ অনুযায়ী কাজ করে এমন অপারেটর:

প্রেরক ও প্রাপক:

  • from:<email> — নির্দিষ্ট ব্যক্তির থেকে পাঠানো হয়েছে।
  • to:<email> — নির্দিষ্ট কোনও ব্যক্তিকে পাঠানো হয়েছে।
  • cc:<email> — Cc-তে নির্দিষ্ট ব্যক্তি।
  • bcc:<email> — Bcc-তে নির্দিষ্ট লোকজন।
  • deliveredto:<email> — নির্দিষ্ট ঠিকানায় ডেলিভার করা হয়েছে।
  • list:<email> — নির্দিষ্ট মেলিং লিস্ট থেকে।

সময় ও তারিখ:

  • after:YYYY/MM/DD / newer:YYYY/MM/DD — কোনও তারিখের পরে পাওয়া গেছে।
  • before:YYYY/MM/DD / older:YYYY/MM/DD — কোনও তারিখের আগে পাওয়া গেছে।
  • older_than:<duration> — নির্দিষ্ট সময়সীমার চেয়ে পুরনো (যেমন, 1y, 2d)।
  • newer_than:<duration> — কোনও সময়সীমার চেয়ে নতুন।

কন্টেন্ট:

  • subject:<words> — সাবজেক্ট লাইনে থাকা শব্দ।
  • has:<type> — নির্দিষ্ট ধরনের কন্টেন্ট আছে (অ্যাটাচমেন্ট, ড্রাইভ, YouTube, ডকুমেন্ট)।
  • filename:<name> — নির্দিষ্ট নাম বা ধরন সহ অ্যাটাচমেন্ট।
  • "<word/phrase>" — কোনও নির্দিষ্ট শব্দ বা বাক্যাংশ সার্চ করুন। (যেমন, "holiday", "holiday vacation")।
  • +<word> — হুবহু একই শব্দ সার্চ করুন। (যেমন, +holiday, +unicorn)
  • rfc822msgid:<id> — নির্দিষ্ট মেসেজ আইডি হেডার।
  • AROUND <distance> — একে অপরের কাছাকাছি শব্দ খুঁজুন (যেমন, holiday AROUND 10 vacation)।

লেবেল ও বিভাগ:

  • label:<name> — নির্দিষ্ট লেবেলের অধীনে। টুলটি লেবেল আইডি গ্রহণ করে, ডিসপ্লে নাম নয়। ID পেতে list_labels টুল ব্যবহার করুন।
  • category:<name> — কোনও বিভাগে (প্রাইমারি, সোশ্যাল, প্রোমোশন, আপডেট, ফোরাম, রিজার্ভেশন, কেনাকাটা)।
  • in:<label> — নির্দিষ্ট লেবেলে সার্চ করুন (আর্কাইভ, স্নুজ করা, ট্র্যাশ, পাঠানো, ইনবক্স)। যেমন, in:trash, in:inbox। আর্কাইভ করা এবং পাঠানো মেসেজ ডিফল্ট হিসেবে অন্তর্ভুক্ত করা হয়; সেগুলি বাদ দিতে -in:archive এবং -in:sent ব্যবহার করুন। টুলটি সাধারণত ড্রাফ্টগুলিকে স্পষ্টভাবে বাদ দেয়। শুধুমাত্র ইনবক্সে সার্চ সীমাবদ্ধ করতে in:inbox ব্যবহার করুন।
  • has:userlabels — কোনও ব্যবহারকারীর লেবেল আছে।
  • has:nouserlabels — কোনও ব্যবহারকারী লেবেল নেই।
  • has:*-star — নির্দিষ্ট স্টারের রঙ (চালু করা থাকলে, যেমন, has:yellow-star)।
  • in:draft — ড্রাফ্টে সার্চ করুন। -in:draft মানে সার্চ ফলাফল থেকে ড্রাফ্ট বাদ দেওয়া।
  • in:sent — পাঠানো মেসেজে সার্চ করুন।
  • in:anywhere — সব ফোল্ডারে সার্চ করুন (স্প্যাম ও ট্র্যাশ সহ)।

স্ট্যাটাস:

  • is:<status> — স্ট্যাটাস অনুযায়ী সার্চ করুন (গুরুত্বপূর্ণ, স্টার চিহ্নিত, অপঠিত, পঠিত, মিউট করা)।

মাপ:

  • size:<bytes> — বাইটে নির্দিষ্ট সাইজ।
  • larger:<size> / smaller:<size> — কোনও সাইজের থেকে বড় বা ছোট (যেমন, 10M ১০ এমবির জন্য)।

লজিক ও গ্রুপিং:

  • AND — সব শর্তাবলী ম্যাচ করুন (ডিফল্ট অ্যাকশন)।
  • OR অথবা { } — এক বা একাধিক শর্তের সাথে মিল (যেমন, from:amy OR from:david, {from:amy from:david})।
  • - (বিয়োগ) — মাপকাঠি বাদ দিন (যেমন, -movie)।
  • ( ) — একাধিক সার্চ করা শব্দ গ্রুপ করুন (যেমন, subject:(dinner film))।

উদাহরণ:

  • subject:OneMCP Update
  • from:user@example.com
  • to:user2@example.com AND newer_than:7d
  • project proposal has:attachment
  • is:unread -in:draft

ইউনিয়ন ফিল্ড _include_trash।

_include_trash শুধুমাত্র নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

includeTrash

boolean

ঐচ্ছিক। ফলাফলে ট্র্যাশ থেকে থ্রেড অন্তর্ভুক্ত করুন। ডিফল্ট হিসেবে false সেট করা থাকে।

ইউনিয়ন ফিল্ড _view।

_view শুধুমাত্র নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

view

enum (ThreadView)

ঐচ্ছিক। থ্রেড তালিকায় থ্রেডের জন্য পপুলেট করা ফিল্ড কন্ট্রোল করে। ডিফল্ট হিসেবে THREAD_VIEW_MINIMAL-এ সেট করা থাকে। THREAD_VIEW_MINIMAL, id, snippet, subject, from, to, cc, date, labelIds রিটার্ন করে। THREAD_VIEW_METADATA_ONLY আইডি, থেকে, পর্যন্ত, সিসি, তারিখ, labelIds রিটার্ন করে।

ThreadView

ListThreads এবং SearchThreads উত্তরে থ্রেডের জন্য পপুলেট করা ফিল্ড নিয়ন্ত্রণ করার enum।

Enums
THREAD_VIEW_UNSPECIFIED ব্যাকওয়ার্ড কম্প্যাটিবিলিটির জন্য THREAD_VIEW_MINIMAL-এ ম্যাপ করে।
THREAD_VIEW_METADATA_ONLY id, from, to, cc, date, labelIds দেখায়।
THREAD_VIEW_MINIMAL id, snippet, subject, from, to, cc, date, labelIds রিটার্ন করে।

আউটপুট স্কিমা

SearchThreads RPC-এর জন্য উত্তর মেসেজ।

SearchThreadsResponse

JSON উপস্থাপনা
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string,
  "resultCountEstimate": string
}
ফিল্ড
threads[]

object (Thread)

থ্রেডের সারাংশের তালিকা।

nextPageToken

string

একটি টোকেন যা থ্রেডের পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে পরবর্তী কলে ব্যবহার করা যেতে পারে। আরও ফলাফল থাকলে তবেই দেখান। কোয়েরির সাথে ম্যাচ করা থ্রেডের সংখ্যা page_size সীমা অতিক্রম করলে, উত্তরে next_page_token থাকবে। ফলাফলের পরবর্তী পৃষ্ঠা পেতে, পরবর্তী SearchThreadsRequest-এর page_token ফিল্ডে এই টোকেন পাস করুন।

resultCountEstimate

string (int64 format)

এই কোয়েরির জন্য আনুমানিক ফলাফল সংখ্যা। এটি সর্বনিম্ন সীমা হিসেবে বিবেচনা করা উচিত, তাই উদাহরণস্বরূপ, এটি ৫০০ হলে, ব্যবহারকারীকে "৫০০+" হিসেবে সংখ্যাটি জানানো যেতে পারে।

থ্রেড

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

CC প্রাপকের ইমেল আইডি।

date

string

ISO 8601 ফর্ম্যাটে (YYYY-MM-DD) মেসেজের তারিখ।

plaintextBody

string

সম্পূর্ণ বডি কন্টেন্ট, MessageFormat, FULL_CONTENT হলে তবেই পপুলেট করা হয়।

attachmentIds[]

string

শুধু আউটপুট। অ্যাটাচমেন্ট আইডি, MessageFormat, FULL_CONTENT হলে তবেই পপুলেট করা হয়।

htmlBody

string

ইমেলের HTML কন্টেন্ট, 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

অ্যাটাচমেন্টের MIME-এর প্রকার।

filename

string

অ্যাটাচমেন্টের ফাইলের নাম।

টুল অ্যানোটেশন

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

অনুমোদনের স্কোপ

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly