MCP Tools Reference: gmailmcp.googleapis.com

Herramienta: get_thread

Recupera un hilo de correo electrónico específico de la cuenta de Gmail del usuario autenticado, incluida una lista de sus mensajes.

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

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": "get_thread",
    "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 GetThread.

GetThreadRequest

Representación JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
Campos
threadId

string

Obligatorio. Es el identificador único del subproceso que se recuperará.
messageFormat

enum (MessageFormat)

Opcional. Especifica el formato de los mensajes que se muestran en el subproceso. La configuración predeterminada es FULL_CONTENT. Nota: Si necesitas contenido del cuerpo o archivos adjuntos, usa FULL_CONTENT. Cuando se usa MINIMAL, no se completarán los campos plaintext_body y attachment_ids. Si no sabes qué formato usar, confía en el comportamiento predeterminado con FULL_CONTENT.

MessageFormat

Es una enumeración para controlar el nivel de detalle de los mensajes del subproceso.

Enums
MESSAGE_FORMAT_UNSPECIFIED La configuración predeterminada es FULL_CONTENT.
MINIMAL Devuelve fragmentos de mensajes y encabezados clave (Asunto, De, Para, Cc, Fecha).
FULL_CONTENT Devuelve toda la información en "MINIMAL" más el contenido completo del cuerpo de cada mensaje.

Esquema de salida

Es un subproceso que contiene una lista de mensajes.

Conversación

Representación JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Campos
id

string

Es el identificador único del subproceso.
messages[]

object (Message)

Es una lista de mensajes del debate, ordenados cronológicamente.

Mensaje

Representación JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ]
}
Campos
id

string

Es el identificador único del mensaje.
snippet

string

Es el fragmento del cuerpo del mensaje.
subject

string

Asunto del mensaje extraído de los encabezados:
sender

string

Dirección de correo electrónico del remitente.
toRecipients[]

string

A las direcciones de correo electrónico de los destinatarios
ccRecipients[]

string

Son las direcciones de correo electrónico de los destinatarios en Cc.
date

string

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

string

Es el contenido completo del cuerpo, que solo se propaga si MessageFormat era FULL_CONTENT.
attachmentIds[]

string

Solo salida. Son los IDs de los archivos adjuntos, que solo se propagan si MessageFormat era FULL_CONTENT.

Anotaciones de herramientas

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