MCP Tools Reference: gmailmcp.googleapis.com

Araç: create_draft

Kimliği doğrulanmış kullanıcının Gmail hesabında yeni bir e-posta taslağı oluşturur.

Bu araç, alıcı adreslerini, konuyu ve gövde içeriğini giriş olarak alır. Oluşturulan Gmail taslağının kimliğini döndürür. Taslak, mevcut bir mesaja yanıt olarak oluşturuluyorsa orijinal mesajın kimliği, replyToMessageId alanında araca iletilmelidir. Ek içeren taslaklar oluşturma henüz desteklenmiyor.

Aşağıdaki örnekte, curl kullanılarak create_draft MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği
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
}'
                

Giriş Şeması

CreateDraft RPC için istek mesajı.

CreateDraftRequest

JSON gösterimi
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string
}
Alanlar
to[]

string

Zorunlu. E-posta taslağının birincil alıcıları. Her dize, geçerli bir düz e-posta adresi OLMALIDIR (ör. "user@example.com"). "Name email@example.com" biçimi bu araç tarafından DESTEKLENMEZ.

cc[]

string

İsteğe bağlı. E-posta taslağının karbon kopya alıcıları. Her dize, geçerli bir düz e-posta adresi OLMALIDIR (ör. "user@example.com"). "Name email@example.com" biçimi bu araç tarafından DESTEKLENMEZ.

bcc[]

string

İsteğe bağlı. E-posta taslağının gizli alıcıları. Her dize, geçerli bir düz e-posta adresi OLMALIDIR (ör. "user@example.com"). "Name email@example.com" biçimi bu araç tarafından DESTEKLENMEZ.

subject

string

İsteğe bağlı. E-postanın konu satırı. Sağlanmazsa varsayılan olarak boş olur.

body

string

İsteğe bağlı. E-posta taslağının ana içerik kısmı. html_body de sağlanırsa bu alan düz metin alternatifi olarak değerlendirilir.

htmlBody

string

E-posta taslağının HTML içeriği. Sağlanırsa bu, e-postanın zengin metin sürümü olarak kullanılır.

replyToMessageId

string

İsteğe bağlı. Yanıtlanacak iletinin kimliği. Sağlanırsa bu, e-posta taslağının yanıtlanacak ileti kimliği olarak kullanılır ve body ile html_body orijinal ileti gövdesine eklenir.

Çıkış şeması

Taslak ayrıntıları.

Taslak

JSON gösterimi
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
Alanlar
id

string

Taslak kaynağın benzersiz tanımlayıcısı.

subject

string

Taslak iletinin konu satırı.

threadId

string

Bu taslağın ait olduğu ileti dizisinin kimliği.

toRecipients[]

string

Üstbilgilerden çıkarılan "Alıcı" alıcısının e-posta adreslerinin listesi.

ccRecipients[]

string

Üstbilgilerden çıkarılan "Cc" alıcısı e-posta adreslerinin listesi.

bccRecipients[]

string

Üstbilgilerden çıkarılan "Bcc" alıcı e-posta adreslerinin listesi.

plaintextBody

string

Varsa düz metin gövde içeriği.

date

string

Taslağın ISO 8601 biçimindeki tarihi (YYYY-AA-GG).

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ❌ | Salt Okunur İpucu: ❌ | Açık Dünya İpucu: ❌