MCP Tools Reference: gmailmcp.googleapis.com

Herramienta: list_drafts

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

Esta herramienta puede filtrar borradores según una cadena de consulta y admite la paginación. Devuelve una lista de borradores, incluidos sus IDs y asuntos. Se puede usar page_token para paginar los resultados. Para recuperar las páginas de resultados posteriores, usa el page_token que se devolvió en la respuesta anterior.

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

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": "list_drafts",
    "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 ListDrafts.

ListDraftsRequest

Representación JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
Campos

Campo de unión _page_size.

_page_size puede ser una de las siguientes opciones:
pageSize

integer

Opcional. Es la cantidad máxima de borradores que se devolverán. Si no se especifica, el valor predeterminado es 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

Opcional. Es un token que se recibió de una llamada a list_drafts anterior 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 y para seguir recuperando resultados desde donde se detuvo la llamada ListDraft anterior, en especial cuando la cantidad de borradores que coinciden con la búsqueda supera el límite de page_size.

Campo de unión _query.

_query puede ser una de las siguientes opciones:
query

string

Ejemplos: "subject:Actualización de OneMCP", "from:gduser1@workspacesamples.dev", "to:gduser2@workspacesamples.dev AND newer_than:7d", "project proposal has:attachment", "is:unread"

Un espacio o un guion (-) separarán un número, mientras que un punto (.) funcionará como decimal. Por ejemplo, 01.2047-100 se considera como dos números: 01.2047 y 100.

Nota: Si queremos asegurarnos de que se devuelvan todos los borradores de la búsqueda, podemos paginar los resultados realizando llamadas repetidas a la herramienta hasta que la respuesta contenga una lista vacía de borradores.

Esquema de salida

Es el mensaje de respuesta para la RPC de ListDrafts.

ListDraftsResponse

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

object (Draft)

Es la lista de borradores.
nextPageToken

string

Es 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 búsqueda 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
}
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: ❌