MCP Tools Reference: gmailmcp.googleapis.com

Alat: list_drafts

Mencantumkan email draf dari akun Gmail pengguna yang diautentikasi.

Alat ini dapat memfilter draf berdasarkan string kueri dan mendukung penomoran halaman. Alat ini menampilkan daftar draf, termasuk ID dan subjeknya.

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

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

Skema Input

Pesan permintaan untuk ListDrafts RPC.

ListDraftsRequest

Representasi JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
Kolom

Kolom union _page_size.

_page_size hanya dapat berupa salah satu dari yang berikut:
pageSize

integer

Opsional. Jumlah maksimum draf 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 yang berikut:
pageToken

string

Opsional. Token yang diterima dari panggilan list_drafts sebelumnya untuk mengambil halaman hasil berikutnya. Biarkan kosong untuk mengambil halaman pertama.

Kolom union _query.

_query hanya dapat berupa salah satu dari yang berikut:
query

string

Opsional. String kueri untuk memfilter draf, menggunakan format yang sama dengan kolom penelusuran Gmail. Jika dihilangkan, semua draf (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"

Skema Output

Pesan respons untuk ListDrafts RPC.

ListDraftsResponse

Representasi JSON 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string
}
Kolom
drafts[]

object (Draft)

Daftar draf.
nextPageToken

string

Token yang dapat digunakan dalam panggilan berikutnya untuk mengambil halaman draf berikutnya. Hanya ada jika ada lebih banyak hasil.

Draf

Representasi JSON 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
Kolom
id

string

ID unik resource draf.
subject

string

Baris subjek pesan draf.
threadId

string

ID thread yang berisi draf ini.
toRecipients[]

string

Daftar alamat email penerima 'Kepada' yang diekstrak dari header.
ccRecipients[]

string

Daftar alamat email penerima 'Cc' yang diekstrak dari header.
bccRecipients[]

string

Daftar alamat email penerima 'Bcc' yang diekstrak dari header.
plaintextBody

string

Konten isi teks biasa, jika tersedia.
date

string

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

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempotensi: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌