MCP Reference: gmailmcp.googleapis.com

Il s'agit d'un serveur MCP fourni par l'API Gmail. Le serveur fournit aux développeurs des outils pour créer des applications LLM sur Gmail.

Un serveur MCP (Model Context Protocol) sert de proxy entre un service externe qui fournit du contexte, des données ou des capacités à un grand modèle de langage (LLM) ou à une application d'IA. Les serveurs MCP connectent les applications d'IA à des systèmes externes tels que des bases de données et des services Web, et traduisent leurs réponses dans un format que l'application d'IA peut comprendre.

Configuration du serveur

Vous devez configurer le serveur MCP Gmail avant de l'utiliser. Pour en savoir plus sur l'utilisation des serveurs MCP distants Google et Google Cloud, consultez Présentation des serveurs MCP Google Cloud.

Points de terminaison du serveur

Un point de terminaison de service MCP est l'adresse réseau et l'interface de communication (généralement une URL) du serveur MCP qu'une application d'IA (l'hôte du client MCP) utilise pour établir une connexion sécurisée et standardisée. Il s'agit du point de contact permettant au LLM de demander du contexte, d'appeler un outil ou d'accéder à une ressource. Les points de terminaison Google MCP peuvent être globaux ou régionaux.

Le serveur MCP de l'API Gmail possède le point de terminaison MCP global suivant :

  • https://gmailmcp.googleapis.com/mcp/v1

Outils MCP

Un outil MCP est une fonction ou une capacité exécutable qu'un serveur MCP expose à un LLM ou à une application d'IA pour effectuer une action dans le monde réel.

Outils

Le serveur MCP gmailmcp.googleapis.com comporte les outils suivants :

Outils MCP
create_draft

Crée un brouillon dans le compte Gmail de l'utilisateur authentifié.

Cet outil prend en entrée les adresses des destinataires, un objet et le contenu du corps du message. Elle renvoie l'ID du brouillon Gmail créé.
list_drafts

Liste les brouillons d'e-mails du compte Gmail de l'utilisateur authentifié.

Cet outil peut filtrer les brouillons en fonction d'une chaîne de requête et est compatible avec la pagination. Elle renvoie une liste des brouillons, y compris leurs ID et leurs sujets.
get_thread Récupère un fil de discussion spécifique à partir du compte Gmail de l'utilisateur authentifié, y compris la liste de ses messages.
search_threads

Liste les fils de discussion du compte 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. Elle 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 complets des messages 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 complet du message si nécessaire.
label_thread

Ajoute des libellés à l'ensemble d'un fil de discussion dans le compte Gmail de l'utilisateur authentifié. Cette opération affecte tous les messages actuellement dans le fil de discussion et tous ceux qui y seront ajoutés à l'avenir.

Si vous n'êtes pas sûr de l'ID du thread, utilisez d'abord l'outil search_threads.

Si vous n'êtes pas sûr de l'ID d'un libellé utilisateur, utilisez d'abord l'outil list_labels pour découvrir les libellés disponibles et leurs ID.
unlabel_thread Supprime les libellés de l'intégralité d'un fil de discussion dans le compte Gmail de l'utilisateur authentifié. Si vous n'êtes pas sûr de l'ID du thread, utilisez d'abord l'outil search_threads. Si vous n'êtes pas sûr de l'ID d'un libellé utilisateur, utilisez d'abord l'outil list_labels.
list_labels Liste tous les libellés définis par l'utilisateur disponibles dans le compte Gmail de l'utilisateur authentifié. Utilisez cet outil pour découvrir le id d'une étiquette utilisateur avant d'appeler label_thread, unlabel_thread, label_message ou unlabel_message. Les libellés système ne sont pas renvoyés par cet outil, mais peuvent être utilisés avec leurs ID connus : "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT".
label_message

Ajoute un ou plusieurs libellés à un message spécifique dans le compte Gmail de l'utilisateur authentifié.

Pour trouver l'ID du message, utilisez des outils tels que search_threads ou get_thread. Si vous n'êtes pas sûr de l'ID d'un libellé utilisateur, utilisez d'abord l'outil list_labels pour découvrir les libellés disponibles et leurs ID.
unlabel_message Supprime un ou plusieurs libellés d'un message spécifique dans le compte Gmail de l'utilisateur authentifié. Pour trouver l'ID du message, utilisez des outils tels que search_threads ou get_thread. Si vous n'êtes pas sûr de l'ID d'un libellé utilisateur, utilisez d'abord l'outil list_labels pour découvrir les libellés disponibles et leurs ID.
create_label Crée un libellé dans le compte Gmail de l'utilisateur authentifié.

Obtenir les spécifications de l'outil MCP

Pour obtenir les spécifications des outils MCP pour tous les outils d'un serveur MCP, utilisez la méthode tools/list. L'exemple suivant montre comment utiliser curl pour lister tous les outils et leurs spécifications actuellement disponibles sur le serveur MCP.

Requête curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'