MCP Tools Reference: gmailmcp.googleapis.com

Strumento: search_threads

Elenca le conversazioni email dell'account Gmail dell'utente autenticato.

Questo strumento può filtrare i thread in base a una stringa di query e supporta la paginazione. Restituisce un elenco di thread, inclusi i relativi ID e messaggi correlati. Ogni messaggio correlato contiene dettagli come uno snippet del corpo del messaggio, l'oggetto, il mittente, i destinatari e così via. Tieni presente che questo strumento non restituisce i corpi completi dei messaggi; utilizza lo strumento "get_thread" con un ID thread per recuperare il corpo completo del messaggio, se necessario.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP search_threads.

Curl Request 
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
}'

Schema di input

Messaggio di richiesta per la RPC SearchThreads.

SearchThreadsRequest

Rappresentazione JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
Campi

Campo unione _page_size.

_page_size può essere solo uno dei seguenti tipi:
pageSize

integer

Facoltativo. Il numero massimo di thread da restituire. Se non specificato, il valore predefinito è 20. Il valore massimo consentito è 50.

Campo unione _page_token.

_page_token può essere solo uno dei seguenti tipi:
pageToken

string

Facoltativo. Token di pagina per recuperare una pagina specifica di risultati nell'elenco. Lascia vuoto per recuperare la prima pagina.

Campo unione _query.

_query può essere solo uno dei seguenti tipi:
query

string

Facoltativo. Una stringa di query per filtrare i thread, utilizzando lo stesso formato della barra di ricerca di Gmail. Se omesso, vengono elencate tutte le conversazioni (esclusi spam e cestino per impostazione predefinita). Operatori chiave: from: - Messaggi inviati da un mittente specifico. a: - Messaggi inviati a un destinatario specifico. subject: - Messaggi con parole specifiche nell'oggetto. - Messaggi contenenti parole specifiche nel corpo o nell'oggetto. is:unread - Messaggi non letti. is:starred - Messaggi speciali. has:attachment - Messaggi con allegati. after:AAAA/MM/GG - Messaggi inviati dopo una data. before:AAAA/MM/GG - Messaggi inviati prima di una 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 unione _include_trash.

_include_trash può essere solo uno dei seguenti tipi:
includeTrash

boolean

Facoltativo. Includi le bozze del CESTINO nei risultati. Il valore predefinito è false.

Schema di output

Messaggio di risposta per la RPC SearchThreads.

SearchThreadsResponse

Rappresentazione JSON 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
Campi
threads[]

object (Thread)

Elenco dei riepiloghi dei thread.
nextPageToken

string

Un token che può essere utilizzato in una chiamata successiva per recuperare la pagina successiva dei thread. Presente solo se sono presenti altri risultati.

Thread

Rappresentazione JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Campi
id

string

L'identificatore univoco del thread.
messages[]

object (Message)

Un elenco di messaggi nel thread, ordinati cronologicamente.

Messaggio

Rappresentazione JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string
}
Campi
id

string

L'identificatore univoco del messaggio.
snippet

string

Snippet del corpo del messaggio.
subject

string

L'oggetto del messaggio estratto dalle intestazioni:
sender

string

Indirizzo email del mittente.
toRecipients[]

string

Agli indirizzi email dei destinatari.
ccRecipients[]

string

Indirizzi email dei destinatari in Cc.
date

string

Data del messaggio nel formato ISO 8601 (AAAA-MM-GG).
plaintextBody

string

Contenuti del corpo completo, compilati solo se MessageFormat era FULL_CONTENT.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌