MCP Tools Reference: gmailmcp.googleapis.com

Outil : search_threads

Affiche les fils de discussion de l'adresse Gmail de l'utilisateur authentifié.

Cet outil peut filtrer les fils de discussion en fonction d'une chaîne de requête et est compatible avec la pagination. Il renvoie une liste de fils de discussion, y compris leurs ID et les messages associés. Chaque message associé contient des informations telles qu'un extrait du corps du message, l'objet, l'expéditeur, les destinataires, etc. Notez que les corps de message complets ne sont pas renvoyés par cet outil. Utilisez l'outil "get_thread" avec un ID de fil de discussion pour récupérer le corps du message complet si nécessaire.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP search_threads.

Requête 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
}'

Schéma d'entrée

Message de requête pour le RPC SearchThreads.

SearchThreadsRequest

Représentation JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
Champs

Champ d'union _page_size.

_page_size ne peut être qu'un des éléments suivants :
pageSize

integer

Facultatif. Nombre maximal de fils de discussion à afficher. Si aucune valeur n'est spécifiée, la valeur définie par défaut est 20. La valeur maximale autorisée est de 50.

Champ d'union _page_token.

_page_token ne peut être qu'un des éléments suivants :
pageToken

string

Facultatif. Jeton de page permettant de récupérer une page spécifique de résultats dans la liste. Laissez ce champ vide pour récupérer la première page.

Champ d'union _query.

_query ne peut être qu'un des éléments suivants :
query

string

Facultatif. Chaîne de requête permettant de filtrer les fils de discussion, au même format que la barre de recherche Gmail. Si ce champ est omis, tous les fils de discussion (à l'exception du spam et de la corbeille par défaut) sont listés. Opérateurs clés : from: - Messages provenant d'un expéditeur spécifique. to: - Messages envoyés à un destinataire spécifique. subject: - Messages contenant des mots spécifiques dans l'objet. - Messages contenant des mots spécifiques dans le corps ou l'objet. is:unread : messages non lus. is:starred : messages avec étoile. has:attachment : messages avec pièces jointes. after:AAAA/MM/JJ : messages envoyés après une date. before:AAAA/MM/JJ : messages envoyés avant une date. newer_than:

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

Champ d'union _include_trash.

_include_trash ne peut être qu'un des éléments suivants :
includeTrash

boolean

Facultatif. Incluez les brouillons de la CORBEILLE dans les résultats. Valeur par défaut : "false".

Schéma de sortie

Message de réponse pour le RPC SearchThreads.

SearchThreadsResponse

Représentation JSON 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
Champs
threads[]

object (Thread)

Liste des résumés des fils de discussion.
nextPageToken

string

Jeton pouvant être utilisé dans un appel ultérieur pour récupérer la page suivante des fils de discussion. Présent uniquement si d'autres résultats sont disponibles.

Thread

Représentation JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Champs
id

string

Identifiant unique du fil de discussion.
messages[]

object (Message)

Liste des messages du fil de discussion, classés par ordre chronologique.

Message

Représentation JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string
}
Champs
id

string

Identifiant unique du message.
snippet

string

Extrait du corps du message.
subject

string

Objet du message extrait des en-têtes :
sender

string

Adresse e-mail de l'expéditeur.
toRecipients[]

string

Adresses e-mail des destinataires.
ccRecipients[]

string

Adresses e-mail des destinataires en copie.
date

string

Date du message au format ISO 8601 (AAAA-MM-JJ).
plaintextBody

string

Contenu complet du corps, renseigné uniquement si MessageFormat est défini sur FULL_CONTENT.

Annotations d'outil

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌