MCP Tools Reference: gmailmcp.googleapis.com

Alat: search_threads

Mencantumkan rangkaian pesan email dari akun Gmail pengguna yang diautentikasi.

Alat ini dapat memfilter rangkaian pesan berdasarkan string kueri dan mendukung penomoran halaman. Alat ini menampilkan daftar rangkaian pesan, termasuk ID dan pesan terkait. 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.

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

Permintaan Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--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 MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Pesan permintaan untuk SearchThreads RPC.

SearchThreadsRequest

Representasi JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
Kolom

Kolom union _page_size.

_page_size hanya dapat berupa salah satu dari 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 berikut:
pageToken

string

Opsional. Token halaman untuk mengambil halaman hasil tertentu dalam daftar. Biarkan kosong untuk mengambil halaman pertama.

Kolom union _query.

_query hanya dapat berupa salah satu dari berikut:
query

string

Opsional. String kueri untuk memfilter rangkaian pesan, menggunakan format yang sama dengan kolom penelusuran Gmail. Jika dihilangkan, semua rangkaian pesan (tidak termasuk spam dan sampah secara default) akan dicantumkan. Operator Kunci: from: - Pesan dari pengirim tertentu. to: - Pesan yang dikirim ke penerima tertentu. subject: - Pesan dengan kata tertentu di subjek. - Pesan yang berisi kata tertentu di isi atau subjek. is:unread - Pesan yang belum dibaca. is:starred - Pesan berbintang. has:attachment - Pesan dengan lampiran. after:YYYY/MM/DD - Pesan yang dikirim setelah tanggal. before:YYYY/MM/DD - Pesan yang dikirim sebelum tanggal. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

Kolom union _include_trash.

_include_trash hanya dapat berupa salah satu dari berikut:
includeTrash

boolean

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

Skema Output

Pesan respons untuk SearchThreads RPC.

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 rangkaian pesan berikutnya. Hanya ada jika ada lebih banyak hasil.

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
}
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

Alamat email penerima.
ccRecipients[]

string

Alamat email penerima CC.
date

string

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

string

Konten isi lengkap, hanya diisi jika MessageFormat adalah FULL_CONTENT.

Anotasi Alat

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