MCP Tools Reference: gmailmcp.googleapis.com

Ferramenta: get_thread

Recupera uma conversa por e-mail específica da conta do Gmail do usuário autenticado, incluindo uma lista de mensagens.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta MCP get_thread.

Solicitação 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

Mensagem de solicitação para GetThread RPC.

GetThreadRequest

Representação JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
Campos
threadId

string

Obrigatório. O identificador exclusivo da conversa a ser buscada.
messageFormat

enum (MessageFormat)

Opcional. Especifica o formato das mensagens retornadas na conversa. O padrão é FULL_CONTENT. Observação: se você precisar do conteúdo do corpo ou de anexos, use FULL_CONTENT. Ao usar MINIMAL, os campos plaintext_body e attachment_ids não serão preenchidos. Se você não tiver certeza de qual formato usar, confie no comportamento padrão usando FULL_CONTENT.

MessageFormat

Enumeração para controlar o nível de detalhes das mensagens na conversa.

Tipos enumerados
MESSAGE_FORMAT_UNSPECIFIED O padrão é FULL_CONTENT.
MINIMAL Retorna snippets de mensagens e cabeçalhos principais (assunto, de, para, Cc, data).
FULL_CONTENT Retorna todas as informações em "MINIMAL" mais o conteúdo completo do corpo de cada mensagem.

Esquema de saída

Conversa contendo uma lista de mensagens.

Conversa

Representação JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Campos
id

string

O identificador exclusivo da conversa.
messages[]

object (Message)

Uma lista de mensagens na conversa, ordenadas cronologicamente.

Mensagem

Representação JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ]
}
Campos
id

string

O identificador exclusivo da mensagem.
snippet

string

Snippet do corpo da mensagem.
subject

string

O assunto da mensagem extraído dos cabeçalhos:
sender

string

Endereço de e-mail do remetente.
toRecipients[]

string

Endereços de e-mail dos destinatários.
ccRecipients[]

string

Endereços de e-mail dos destinatários em cópia.
date

string

Data da mensagem no formato ISO 8601 (AAAA-MM-DD).
plaintextBody

string

Conteúdo completo do corpo, preenchido apenas se MessageFormat for FULL_CONTENT.
attachmentIds[]

string

Apenas saída. Os IDs dos anexos, preenchidos apenas se MessageFormat for FULL_CONTENT.

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌