MCP Tools Reference: gmailmcp.googleapis.com

Alat: search_threads

Mencantumkan rangkaian email dari akun Gmail pengguna terautentikasi.

Alat ini dapat memfilter rangkaian pesan berdasarkan string kueri dan mendukung penomoran halaman. Tindakan ini akan menampilkan daftar rangkaian pesan, termasuk ID dan pesan terkaitnya. Setiap pesan terkait berisi detail seperti cuplikan isi pesan, subjek, pengirim, penerima, dll. Perhatikan bahwa isi pesan lengkap tidak ditampilkan oleh alat ini; gunakan alat 'get_thread' dengan ID rangkaian pesan untuk mengambil isi pesan lengkap jika diperlukan. Thread dengan kriteria yang dikecualikan mungkin masih muncul di hasil. Hal ini terjadi karena Gmail mengidentifikasi pesan yang cocok terlebih dahulu. Misalnya, jika Anda menelusuri -is:starred, Gmail akan menemukan seluruh rangkaian pesan jika rangkaian pesan tersebut berisi setidaknya satu pesan yang tidak berbintang, meskipun email lain dalam percakapan yang sama berbintang.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP search_threads.

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

Skema Input

Pesan permintaan untuk RPC SearchThreads.

SearchThreadsRequest

Representasi JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
Kolom

Kolom union _page_size.

_page_size hanya dapat berupa salah satu dari hal berikut:
pageSize

integer

Opsional. Jumlah maksimum rangkaian pesan yang akan ditampilkan. Jika tidak ditentukan, nilai defaultnya adalah 20. Nilai maksimum yang diizinkan adalah 50.

Kolom union _page_token.

_page_token hanya dapat berupa salah satu dari hal berikut:
pageToken

string

Opsional. Token halaman untuk mengambil halaman hasil tertentu dalam daftar. Biarkan kosong untuk mengambil halaman pertama. Parameter ini terutama digunakan untuk penomoran halaman guna melanjutkan pengambilan hasil dari tempat panggilan SearchThreads sebelumnya berhenti, terutama saat jumlah thread yang cocok dengan kueri melebihi batas page_size.

Kolom union _query.

_query hanya dapat berupa salah satu dari hal berikut:
query

string

Opsional. String kueri untuk memfilter rangkaian pesan. Kueri bahasa alami harus dikonversi terlebih dahulu menjadi kueri sintaksis Gmail untuk menggunakan alat ini. Jika tidak disertakan, semua rangkaian pesan (kecuali spam dan sampah secara default) akan dicantumkan.

Operator yang Didukung menurut Kategori:

Pengirim & Penerima: from: - Dikirim dari orang tertentu. kepada: - Dikirim ke orang tertentu. cc: - Orang tertentu di Cc. bcc: - Orang tertentu di Bcc. deliveredto: - Dikirim ke alamat tertentu. list: - Dari milis tertentu.

Waktu & Tanggal: after:YYYY/MM/DD / newer:YYYY/MM/DD - Diterima setelah tanggal. before:YYYY/MM/DD / older:YYYY/MM/DD - Diterima sebelum tanggal. older_than: - Lebih lama dari durasi (misalnya, 1y, 2d). newer_than: - Lebih baru dari durasi.

Konten: subject: - Kata-kata dalam baris subjek. has: - Memiliki jenis konten tertentu (lampiran, drive, youtube, dokumen). filename: - Lampiran dengan nama atau jenis tertentu. "<kata/frasa>" - Menelusuri kata atau frasa yang sama persis. (misalnya, "liburan", "liburan panjang"). + - Mencocokkan kata persis. (misalnya, +liburan, +unicorn) rfc822msgid: - Header ID pesan tertentu. AROUND - Menemukan kata-kata yang saling berdekatan (misalnya, holiday AROUND 10 vacation).

Label & Kategori: label: - Dalam label tertentu. Alat ini menerima ID label, bukan nama tampilan. Gunakan alat list_labels untuk mendapatkan ID. category: - Dalam kategori (utama, sosial, promosi, info terbaru, forum, reservasi, pembelian). in:

Status: is: - Menelusuri menurut status (penting, berbintang, belum dibaca, telah dibaca, disenyapkan).

Ukuran: size: - Ukuran tertentu dalam byte. lebih besar: / lebih kecil: - Lebih besar atau lebih kecil dari ukuran (misalnya, 10M untuk 10 MB).

Logika & Pengelompokan: AND - Cocokkan semua kriteria (perilaku default). OR atau { } - Mencocokkan satu atau beberapa kriteria (misalnya, from:amy OR from:david, {from:amy from:david}). - (minus) - Mengecualikan kriteria (misalnya, -film). ( ) - Mengelompokkan beberapa istilah penelusuran (misalnya, subject:(makan malam film)).

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

Kolom union _include_trash.

_include_trash hanya dapat berupa salah satu dari hal berikut:
includeTrash

boolean

Opsional. Sertakan draf dari SAMPAH dalam hasil. Nilai defaultnya adalah false (salah).

Skema Output

Pesan respons untuk RPC SearchThreads.

SearchThreadsResponse

Representasi JSON 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
Kolom
threads[]

object (Thread)

Daftar ringkasan rangkaian pesan.
nextPageToken

string

Token yang dapat digunakan dalam panggilan berikutnya untuk mengambil halaman berikutnya dari rangkaian pesan. Hanya ada jika ada hasil lainnya. Jika jumlah rangkaian pesan yang cocok dengan kueri melebihi batas page_size, respons akan berisi next_page_token. Untuk mengambil halaman hasil berikutnya, teruskan token ini di kolom page_token dari SearchThreadsRequest berikutnya.

Rangkaian pesan

Representasi JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Kolom
id

string

ID unik rangkaian pesan.
messages[]

object (Message)

Daftar pesan dalam rangkaian pesan, diurutkan secara kronologis.

Pesan

Representasi JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ]
}
Kolom
id

string

ID unik pesan.
snippet

string

Cuplikan isi pesan.
subject

string

Subjek pesan yang diekstrak dari header:
sender

string

Alamat email pengirim.
toRecipients[]

string

Ke alamat email penerima.
ccRecipients[]

string

Alamat email penerima CC.
date

string

Tanggal pesan dalam format ISO 8601 (YYYY-MM-DD).
plaintextBody

string

Konten isi pesan lengkap, hanya diisi jika MessageFormat adalah FULL_CONTENT.
attachmentIds[]

string

Hanya output. ID lampiran, hanya diisi jika MessageFormat adalah FULL_CONTENT.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌