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.

El parámetro messageFormat opcional controla el formato de los mensajes que se muestran. De forma predeterminada (o con FULL_CONTENT), muestra el contenido completo de los mensajes. Usa MINIMAL para incluir solo el asunto y el fragmento (sin incluir el cuerpo). Usa METADATA_ONLY para incluir solo metadatos básicos (ID del mensaje, ID del hilo, etiquetas, marca de tiempo y estimación del tamaño).

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

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

Esquema de entrada

Mensaje de solicitud para GetThread RPC.

GetThreadRequest

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

string

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

enum (MessageFormat)

Es opcional. Especifica el formato de los mensajes que se muestran dentro del hilo. La configuración predeterminada es FULL_CONTENT. Nota: El formato MINIMAL muestra id, snippet, subject, from, to, cc, date, labelIds. El formato METADATA_ONLY muestra id, from, to, cc, date, labelIds. FULL_CONTENT muestra id, snippet, subject, from, to, cc, date, labelIds, attachmentIds, plaintextBody, htmlBody, attachments.

MessageFormat

Enum para controlar el nivel de detalle de los mensajes en el hilo.

Enums
MESSAGE_FORMAT_UNSPECIFIED La configuración predeterminada es FULL_CONTENT.
MINIMAL Muestra fragmentos de mensajes y encabezados clave (asunto, de, para, cc, fecha).
FULL_CONTENT Muestra toda la información en "MINIMAL" más el contenido completo del cuerpo de cada mensaje.
METADATA_ONLY Solo metadatos: no incluye el asunto, el fragmento, el cuerpo ni los nombres de archivo adjunto.

Esquema de salida

Es un hilo que contiene una lista de mensajes.

Thread

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

string

Es el identificador único del hilo.
messages[]

object (Message)

Es una lista de mensajes en el hilo, 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
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    string
  ]
}
Campos
id

string

Es el identificador único del mensaje.
snippet

string

Es el fragmento del cuerpo del mensaje.
subject

string

Es el asunto del mensaje extraído de los encabezados:
sender

string

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

string

Direcciones de correo electrónico de los destinatarios
ccRecipients[]

string

Direcciones de correo electrónico de los destinatarios incluidos en el campo Cc
date

string

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

string

Contenido completo del cuerpo, solo propagado si MessageFormat era FULL_CONTENT
attachmentIds[]

string

Solo salida. Los IDs de los archivos adjuntos, solo propagados si MessageFormat era FULL_CONTENT
htmlBody

string

El contenido HTML del correo electrónico, solo propagado si MessageFormat era FULL_CONTENT
attachments[]

object (AttachmentMetadata)

Solo salida. Los archivos adjuntos, solo propagados si MessageFormat era FULL_CONTENT
labelIds[]

string

Los IDs de las etiquetas adjuntas al mensaje Incluye IDs de etiquetas de usuario y etiquetas estándar del sistema limitadas a INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT y CHAT.

AttachmentMetadata

Representación JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Campos
id

string

Solo salida. Es el ID del archivo adjunto.
mimeType

string

Es el tipo de MIME del archivo adjunto.
filename

string

Es el nombre del archivo adjunto.

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.readonly
  • https://www.googleapis.com/auth/gmail.metadata