Ferramenta: create_draft
Cria um novo rascunho de e-mail na conta do Gmail do usuário autenticado.
Essa ferramenta usa como entradas endereços de destinatários, um assunto e o conteúdo do corpo. Ele retorna o ID do rascunho do Gmail criado.
O exemplo a seguir demonstra como usar curl para invocar a ferramenta create_draft MCP.
| Solicitação 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": "create_draft", "arguments": { // provide these details according to the tool MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Esquema de entrada
Mensagem de solicitação para RPC CreateDraft.
CreateDraftRequest
| Representação JSON |
|---|
{ "to": [ string ], "cc": [ string ], "bcc": [ string ], "subject": string, "body": string, "htmlBody": string } |
| Campos | |
|---|---|
to[] |
Obrigatório. Os destinatários principais do rascunho de e-mail. Cada string precisa ser um endereço de e-mail válido (por exemplo, "user@example.com"). O formato "Nome email@example.com" NÃO é compatível com essa ferramenta. |
cc[] |
Opcional. Os destinatários da cópia carbono do rascunho de e-mail. Cada string precisa ser um endereço de e-mail válido (por exemplo, "user@example.com"). O formato "Nome email@example.com" NÃO é compatível com essa ferramenta. |
bcc[] |
Opcional. Os destinatários da cópia oculta do rascunho de e-mail. Cada string precisa ser um endereço de e-mail válido (por exemplo, "user@example.com"). O formato "Nome email@example.com" NÃO é compatível com essa ferramenta. |
subject |
Opcional. A linha de assunto do e-mail. O padrão será vazio se não for informado. |
body |
Opcional. O conteúdo principal do corpo do rascunho de e-mail. Se "html_body" também for fornecido, esse campo será tratado como a alternativa de texto simples. |
htmlBody |
O conteúdo HTML do rascunho de e-mail. Se fornecido, ele será usado como a versão em rich text do e-mail. |
Esquema de saída
Detalhes de um rascunho.
Rascunho
| Representação JSON |
|---|
{ "id": string, "subject": string, "threadId": string, "toRecipients": [ string ], "ccRecipients": [ string ], "bccRecipients": [ string ], "plaintextBody": string, "date": string } |
| Campos | |
|---|---|
id |
O identificador exclusivo do recurso de rascunho. |
subject |
A linha de assunto da mensagem em rascunho. |
threadId |
O ID da conversa a que este rascunho pertence. |
toRecipients[] |
Lista de endereços de e-mail de destinatários em "Para" extraídos dos cabeçalhos. |
ccRecipients[] |
Lista de endereços de e-mail de destinatários em "Cc" extraídos dos cabeçalhos. |
bccRecipients[] |
Lista de endereços de e-mail de destinatários em "Cco" extraídos dos cabeçalhos. |
plaintextBody |
Conteúdo do corpo de texto simples, se disponível. |
date |
Data do rascunho no formato ISO 8601 (AAAA-MM-DD). |
Anotações de ferramentas
Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌