MCP Tools Reference: gmailmcp.googleapis.com

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[]

string

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[]

string

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[]

string

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

string

Opcional. A linha de assunto do e-mail. O padrão será vazio se não for informado.

body

string

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

string

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

string

O identificador exclusivo do recurso de rascunho.

subject

string

A linha de assunto da mensagem em rascunho.

threadId

string

O ID da conversa a que este rascunho pertence.

toRecipients[]

string

Lista de endereços de e-mail de destinatários em "Para" extraídos dos cabeçalhos.

ccRecipients[]

string

Lista de endereços de e-mail de destinatários em "Cc" extraídos dos cabeçalhos.

bccRecipients[]

string

Lista de endereços de e-mail de destinatários em "Cco" extraídos dos cabeçalhos.

plaintextBody

string

Conteúdo do corpo de texto simples, se disponível.

date

string

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: ❌