MCP Tools Reference: gmailmcp.googleapis.com

Ferramenta: get_message

Recupera uma mensagem de e-mail específica da conta do Gmail do usuário autenticado pelo ID exclusivo da mensagem.

Use essa ferramenta para inspecionar um único e-mail quando você já souber o ID da mensagem. Se o usuário quiser ler um e-mail específico em detalhes, verificar a redação exata de uma mensagem ou examinar os metadados de anexo de um único e-mail, essa é a ferramenta certa. Ela não é adequada para recuperar conversas inteiras ou visualizar conversas de discussão; use a ferramenta "get_thread". Os principais indicadores incluem se o usuário pede o conteúdo completo de um ID de mensagem específico retornado por uma pesquisa anterior ou se a consulta pede para inspecionar um e-mail individual específico em vez de uma conversa inteira. Exemplos de comandos do usuário: "Receber o texto completo do ID da mensagem 18f123456789abcd.", "Ler a mensagem mais recente nessa conversa de Alice" e "Quais são os nomes dos anexos no e-mail que acabei de receber do RH?"

O parâmetro opcional messageFormat controla o formato da mensagem retornada. Por padrão (ou com FULL_CONTENT), ele retorna o conteúdo completo da mensagem. Use MINIMAL para incluir apenas o assunto e o snippet (excluindo o corpo). Use METADATA_ONLY para incluir apenas metadados básicos (ID da mensagem, ID da conversa, rótulos, carimbo de data/hora e estimativa de tamanho).

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

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

Esquema de entrada

Mensagem de solicitação para GetMessage RPC.

GetMessageRequest

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

string

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

enum (MessageFormat)

Opcional. Especifica o formato da mensagem retornada. O padrão é 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 de cada mensagem.
METADATA_ONLY Somente metadados: não inclui assunto, snippet, corpo, nomes de arquivos anexados.

Esquema de saída

Mensagem em uma conversa.

Mensagem

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

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 do destinatário.
ccRecipients[]

string

Endereços de e-mail do destinatário 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 de anexo, preenchidos apenas se MessageFormat for FULL_CONTENT.
htmlBody

string

O conteúdo HTML do e-mail, preenchido apenas se MessageFormat for FULL_CONTENT.
attachments[]

object (AttachmentMetadata)

Apenas saída. Os anexos, preenchidos apenas se MessageFormat for FULL_CONTENT.
labelIds[]

string

Os IDs dos rótulos anexados à mensagem. Inclui IDs de rótulos de usuário e rótulos de sistema padrão limitados a INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT.

AttachmentMetadata

Representação JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Campos
id

string

Apenas saída. O ID do anexo.
mimeType

string

O tipo MIME do anexo.
filename

string

O nome do arquivo do anexo.

Anotações de ferramentas

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

Escopos de autorização

Requer um dos seguintes escopos do 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