MCP Tools Reference: gmailmcp.googleapis.com

Herramienta: list_drafts

Muestra los correos electrónicos borrador de la cuenta de Gmail del usuario autenticado.

Esta herramienta puede filtrar borradores en función de una cadena de consulta y admite la paginación. Muestra una lista de borradores, incluidos sus IDs y asuntos (a menos que view se establezca en DRAFT_VIEW_METADATA_ONLY). page_token se puede usar para paginar los resultados. Para recuperar las páginas posteriores de resultados, usa el page_token que se muestra en la respuesta anterior.

El parámetro view controla qué campos se propagan en la respuesta. De forma predeterminada (o con DRAFT_VIEW_FULL), muestra el contenido completo. Usa DRAFT_VIEW_METADATA_ONLY para excluir contenido sensible, como el asunto y el cuerpo.

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

Solicitud de Curl 
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": "list_drafts",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensaje de solicitud para ListDrafts RPC.

ListDraftsRequest

Representación JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "view": enum (DraftView)
}
Campos

Campo de unión _page_size.

_page_size puede ser una de las siguientes opciones:
pageSize

integer

Es opcional. Es la cantidad máxima de borradores que se devolverán. Si no se especifica, se establece de forma predeterminada como 20. El valor máximo permitido es 50.

Campo de unión _page_token.

_page_token puede ser una de las siguientes opciones:
pageToken

string

Es opcional. Es un token que se recibió de una llamada anterior a list_drafts para recuperar la siguiente página de resultados. Déjalo vacío para obtener la primera página. Se usa principalmente para la paginación para seguir recuperando resultados desde donde se detuvo la llamada anterior a ListDraft, en especial, cuando la cantidad de borradores que coinciden con la consulta supera el límite de page_size.

Campo de unión _query.

_query puede ser una de las siguientes opciones:
query

string

Ejemplos:

  • subject:OneMCP Update
  • from:gduser1@workspacesamples.dev
  • to:gduser2@workspacesamples.dev AND newer_than:7d
  • project proposal has:attachment
  • is:unread

El espacio o guion (-) te permiten separar un número, mientras que el punto (.) funciona como decimal. Por ejemplo, 01.2047-100 cuenta como dos números: 01.2047 y 100.

Nota: Si queremos asegurarnos de que se muestren todos los borradores de la consulta, podemos paginar los resultados haciendo llamadas repetidas a la herramienta hasta que la respuesta contenga una lista vacía de borradores.

Campo de unión _view.

_view puede ser una de las siguientes opciones:
view

enum (DraftView)

Es opcional. Controla los campos propagados para los borradores en la lista de borradores. De forma predeterminada (o con DRAFT_VIEW_FULL), muestra el contenido completo, que tiene el ID del borrador, el ID del subproceso, para, cc, cco, fecha, asunto y cuerpo. Usa DRAFT_VIEW_METADATA_ONLY para excluir el asunto y el cuerpo.

DraftView

Enum para controlar los campos propagados para los borradores en la respuesta de ListDrafts.

Enums
DRAFT_VIEW_UNSPECIFIED Se asigna a DRAFT_VIEW_FULL para la retrocompatibilidad.
DRAFT_VIEW_METADATA_ONLY Solo metadatos: No incluye asunto, plaintext_body ni html_body.
DRAFT_VIEW_FULL Metadatos + UGC (comportamiento predeterminado).

Esquema de salida

Mensaje de respuesta para ListDrafts RPC.

ListDraftsResponse

Representación JSON 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string
}
Campos
drafts[]

object (Draft)

Lista de borradores.
nextPageToken

string

Un token que se puede usar en una llamada posterior para recuperar la siguiente página de borradores. Si la cantidad de borradores que coinciden con la consulta supera el límite de page_size, la respuesta contendrá un next_page_token. Para recuperar la siguiente página de resultados, pasa este token en el campo page_token del siguiente ListDraftsRequest.

Borrador

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

string

El identificador único del recurso de borrador.
subject

string

El asunto del mensaje borrador.
threadId

string

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

string

Lista de direcciones de correo electrónico del destinatario "Para" extraídas de los encabezados.
ccRecipients[]

string

Lista de direcciones de correo electrónico del destinatario "Cc" extraídas de los encabezados.
bccRecipients[]

string

Lista de direcciones de correo electrónico del destinatario "Cco" extraídas 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).
htmlBody

string

El contenido del cuerpo HTML del borrador, si está disponible.

Anotaciones de herramientas

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

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

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