MCP Tools Reference: gmailmcp.googleapis.com

Alat: create_draft

Membuat draf email baru di akun Gmail pengguna yang diautentikasi.

Alat ini menggunakan alamat penerima, subjek, dan isi konten sebagai input. Fungsi ini menampilkan ID draf Gmail yang dibuat. Jika draf dibuat sebagai balasan untuk pesan yang ada, ID pesan asli harus diteruskan ke alat di kolom replyToMessageId. Membuat draf dengan lampiran belum didukung.

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

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

Skema Input

Pesan permintaan untuk RPC CreateDraft.

CreateDraftRequest

Representasi JSON 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string
}
Kolom
to[]

string

Wajib. Penerima utama draf email. Setiap string HARUS berupa alamat email biasa yang valid (misalnya, "user@example.com"). Format "Name email@example.com" TIDAK didukung oleh alat ini.
cc[]

string

Opsional. Penerima salinan karbon draf email. Setiap string HARUS berupa alamat email biasa yang valid (misalnya, "user@example.com"). Format "Name email@example.com" TIDAK didukung oleh alat ini.
bcc[]

string

Opsional. Penerima salinan karbon rahasia draf email. Setiap string HARUS berupa alamat email biasa yang valid (misalnya, "user@example.com"). Format "Name email@example.com" TIDAK didukung oleh alat ini.
subject

string

Opsional. Baris subjek email. Nilai defaultnya adalah kosong jika tidak diberikan.
body

string

Opsional. Konten isi utama draf email. Jika html_body juga diberikan, kolom ini akan diperlakukan sebagai alternatif teks biasa.
htmlBody

string

Konten HTML draf email. Jika disediakan, ini akan digunakan sebagai versi email teks kaya.
replyToMessageId

string

Opsional. ID pesan yang akan dibalas. Jika diberikan, ID ini akan digunakan sebagai ID pesan balas untuk draf email, dan body serta html_body akan ditambahkan ke isi pesan asli.

Skema Output

Detail draf.

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 rangkaian pesan tempat draf ini berada.
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 Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌