MCP Reference: gmailmcp.googleapis.com

Un serveur Model Context Protocol (MCP) fait office de proxy entre un service externe qui fournit le contexte, les données ou les 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.

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.

Le serveur MCP gmailmcp.googleapis.com dispose des outils suivants :

Outils MCP
create_draft

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

Cet outil prend comme entrées les adresses des destinataires, un objet et le contenu du corps du message. Il renvoie l'ID du brouillon Gmail créé.

list_drafts

Liste les brouillons 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. Il renvoie une liste de brouillons, y compris leurs ID et leurs objets.

get_thread Récupère un fil de discussion spécifique du compte Gmail de l'utilisateur authentifié, y compris une 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. Il renvoie une liste de fils de discussion, y compris leurs ID et les messages associés. Chaque message associé contient des détails tels 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.

label_thread

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

Si vous n'êtes pas sûr de l'ID du fil de discussion, 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 d'un fil de discussion entier dans le compte Gmail de l'utilisateur authentifié. Si vous n'êtes pas sûr de l'ID du fil de discussion, 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 l'id d'un libellé 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 des outils 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 dans le serveur MCP.

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/list",
    "jsonrpc": "2.0",
    "id": 1
}'