MCP Tools Reference: gmailmcp.googleapis.com

Ferramenta: search_threads

Lista as conversas por e-mail da conta do Gmail do usuário autenticado.

Essa ferramenta pode filtrar conversas com base em uma string de consulta e oferece suporte à paginação. Ela retorna uma lista de conversas, incluindo os IDs e as mensagens relacionadas. Cada mensagem relacionada contém detalhes como um snippet do corpo da mensagem, o assunto, o remetente, os destinatários etc. Os corpos completos das mensagens não são retornados por essa ferramenta. Use a ferramenta "get_thread" com um ID de conversa para buscar o corpo completo da mensagem, se necessário.

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

Solicitação curl 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_threads",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação para SearchThreads RPC.

SearchThreadsRequest

Representação JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
Campos

Campo de união _page_size.

_page_size pode ser apenas de um dos tipos a seguir:
pageSize

integer

Opcional. O número máximo de conversas a serem retornadas. Se não for especificado, o padrão será 20. O valor máximo permitido é 50.

Campo de união _page_token.

_page_token pode ser apenas de um dos tipos a seguir:
pageToken

string

Opcional. Token de página para recuperar uma página específica de resultados na lista. Deixe em branco para buscar a primeira página.

Campo de união _query.

_query pode ser apenas de um dos tipos a seguir:
query

string

Opcional. Uma string de consulta para filtrar as conversas, usando o mesmo formato da pesquisa no Gmail. Se omitido, todas as conversas (exceto spam e lixeira por padrão) serão listadas. Operadores de chave: from: - mensagens de um remetente específico. to: - mensagens enviadas a um destinatário específico. subject: - mensagens com palavras específicas no assunto. - mensagens que contêm palavras específicas no corpo ou no assunto. is:unread - mensagens não lidas. is:starred - mensagens marcadas com estrela. has:attachment - mensagens com anexos. after:AAAA/MM/DD - mensagens enviadas após uma data. before:AAAA/MM/DD - mensagens enviadas antes de uma data. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

Campo de união _include_trash.

_include_trash pode ser apenas de um dos tipos a seguir:
includeTrash

boolean

Opcional. Incluir rascunhos da LIXEIRA nos resultados. O padrão é "falso".

Esquema de saída

Mensagem de resposta para SearchThreads RPC.

SearchThreadsResponse

Representação JSON 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
Campos
threads[]

object (Thread)

Lista de resumos de conversas.
nextPageToken

string

Um token que pode ser usado em uma chamada subsequente para recuperar a próxima página de conversas. Presente apenas se houver mais resultados.

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
}
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.

Anotações da ferramenta

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