MCP Tools Reference: gmailmcp.googleapis.com

Herramienta: create_draft

Crea un nuevo borrador de correo electrónico en la cuenta de Gmail del usuario autenticado.

Esta herramienta toma como entradas las direcciones de los destinatarios, un asunto y el contenido del cuerpo. Devuelve el ID del borrador de Gmail creado. Si el borrador se crea como respuesta a un mensaje existente, el ID del mensaje original se debe pasar a la herramienta en el campo replyToMessageId. Aún no se admite la creación de borradores con archivos adjuntos.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP create_draft.

Solicitud de 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

Es el mensaje de solicitud para la RPC de CreateDraft.

CreateDraftRequest

Representación JSON 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string
}
Campos
to[]

string

Obligatorio. Son los destinatarios principales del borrador de correo electrónico. Cada cadena DEBE ser una dirección de correo electrónico simple válida (p.ej., "usuario@example.com"). La herramienta NO admite el formato "Nombre email@example.com".
cc[]

string

Opcional. Son los destinatarios de la copia al carbón del borrador del correo electrónico. Cada cadena DEBE ser una dirección de correo electrónico simple válida (p.ej., "usuario@example.com"). La herramienta NO admite el formato "Nombre email@example.com".
bcc[]

string

Opcional. Son los destinatarios de la copia oculta del borrador del correo electrónico. Cada cadena DEBE ser una dirección de correo electrónico simple válida (p.ej., "usuario@example.com"). La herramienta NO admite el formato "Nombre email@example.com".
subject

string

Opcional. Es el asunto del correo electrónico. Si no se proporciona, el valor predeterminado es vacío.
body

string

Opcional. Es el contenido principal del borrador del correo electrónico. Si también se proporciona html_body, este campo se trata como la alternativa de texto sin formato.
htmlBody

string

Es el contenido HTML del borrador del correo electrónico. Si se proporciona, se usará como la versión de texto enriquecido del correo electrónico.
replyToMessageId

string

Opcional. ID del mensaje al que se responderá. Si se proporciona, se usará como el ID del mensaje de respuesta para el borrador de correo electrónico, y se agregarán body y html_body al cuerpo del mensaje original.

Esquema de salida

Son los detalles de un borrador.

Borrador

Representación JSON 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
Campos
id

string

Es el identificador único del recurso de borrador.
subject

string

Es el asunto del mensaje de borrador.
threadId

string

Es el ID del subproceso al que pertenece este borrador.
toRecipients[]

string

Es la lista de direcciones de correo electrónico de los destinatarios en "Para" que se extrajeron de los encabezados.
ccRecipients[]

string

Es la lista de direcciones de correo electrónico de los destinatarios en "Cc" que se extrajeron de los encabezados.
bccRecipients[]

string

Es la lista de direcciones de correo electrónico de los destinatarios en "Cco" que se extrajeron de los encabezados.
plaintextBody

string

Contenido del cuerpo de texto sin formato, si está disponible.
date

string

Fecha del borrador en formato ISO 8601 (AAAA-MM-DD).

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ❌ | Sugerencia de solo lectura: ❌ | Sugerencia de mundo abierto: ❌