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 recebe como entrada os endereços dos destinatários, um assunto e o conteúdo do corpo. Ela retorna o ID do rascunho do Gmail criado. Se o rascunho for criado como uma resposta a uma mensagem, o ID da mensagem original precisará ser transmitido à ferramenta no campo replyToMessageId. Ainda não é possível criar rascunhos com anexos.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta MCP create_draft.

Solicitação 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
}'

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,
  "replyToMessageId": 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 simples válido (por exemplo, "usuario@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 simples válido (por exemplo, "usuario@example.com"). O formato "Nome email@example.com" NÃO é compatível com essa ferramenta.
bcc[]

string

Opcional. Os destinatários da cópia carbono oculta do rascunho de e-mail. Cada string PRECISA ser um endereço de e-mail simples válido (por exemplo, "usuario@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 fornecido.
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 de texto avançado do e-mail.
replyToMessageId

string

Opcional. O ID da mensagem a que responder. Se fornecido, ele será usado como o ID da mensagem de resposta para o rascunho de e-mail, e o body e o html_body serão anexados ao corpo da mensagem original.

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 de rascunho.
threadId

string

O ID da conversa a que esse rascunho pertence.
toRecipients[]

string

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

string

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

string

Lista de endereços de e-mail de destinatários "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 da ferramenta

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌