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. Taslak, mevcut bir mesaja yanıt olarak oluşturulursa orijinal mesajın kimliği, replyToMessageId alanında araca iletilmelidir.

Yalnızca taslak iletinin benzersiz kimliğini (id) döndürür.

Sınırlama: Ek içeren taslaklar oluşturma henüz desteklenmemektedir.

Aşağıdaki örnekte, create_draft MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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,
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
Alanlar
to[]

string

İsteğe bağlı. E-posta taslağının birincil alıcıları. Her dize, geçerli bir düz e-posta adresi (ör. "user@example.com") OLMALIDIR. "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 (ör. "user@example.com") OLMALIDIR. "Name email@example.com" biçimi bu araç tarafından DESTEKLENMEZ.
bcc[]

string

İsteğe bağlı. E-posta taslağının Bcc alanındaki alıcılar. Her dize, geçerli bir düz e-posta adresi (ör. "user@example.com") OLMALIDIR. "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 gövde içeriği. 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.
attachments[]

object (Attachment)

İsteğe bağlı. E-postaya eklenecek ekler. İletideki eklerin toplam boyutu 25 MB'ı aşamaz. 25 MB'tan büyük dosyalar göndermeniz gerekiyorsa önce dosyayı Drive'a yükleyin, ardından Drive bağlantısını body veya html_body'ye ekleyin.

Ek

JSON gösterimi 
{
  "id": string,
  "filename": string,
  "mimeType": string,
  "content": string,
  "inline": boolean
}
Alanlar
id

string

İsteğe bağlı. Yalnızca çıkış. Mevcut olduğunda, ayrı bir GetMessageAttachment isteğiyle alınabilen harici bir ek dosyanın kimliğini içerir.
filename

string

İsteğe bağlı. Eklenecek dosyanın adı (ör. "fatura.pdf"). Satır içi eklerde, Content-ID oluşturmak için kullanılır. Normal eklerde, dosya adı, e-posta istemcilerine gönderilecek dosya adını belirtmek için kullanılır. Belirtilmezse ek, ad olmadan alınabilir.
mimeType

string

İsteğe bağlı. İçerik veya medya türünü temsil eden alan, IANA MIME türünü kullanmalıdır: https://www.iana.org/assignments/media-types/media-types.xhtml. Belirtilmezse varsayılan olarak "application/octet-stream" olur.
content

string (bytes format)

Zorunlu. Ekin base64 kodlu içeriği.

Base64 kodlu bir dize.
inline

boolean

İsteğe bağlı. Doğruysa bu ek satır içi olarak işlenir. Satır içi ek, indirilmek üzere ayrı bir dosya olarak listelenmek yerine bir HTML e-postasının gövdesinde gösterilmesi amaçlanan içeriktir. Yanlışsa veya yoksa varsayılan olarak yanlış kabul edilir ve normal ek olarak değerlendirilir.

Çı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,
  "htmlBody": 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ısı 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).
htmlBody

string

Varsa taslağın HTML gövde içeriği.

Araç Ek Açıklamaları

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

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.compose