MCP Reference: gmailmcp.googleapis.com

Si tratta di un server MCP fornito dall'API Gmail. Il server fornisce agli sviluppatori gli strumenti per creare applicazioni LLM basate su Gmail.

Un server Model Context Protocol (MCP) funge da proxy tra un servizio esterno che fornisce contesto, dati o funzionalità a un modello linguistico di grandi dimensioni (LLM) o a un'applicazione AI. I server MCP collegano le applicazioni AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato che l'applicazione AI può comprendere.

Configurazione del server

Prima di utilizzarlo, devi configurare il server MCP di Gmail. Per saperne di più sull'utilizzo dei server MCP remoti di Google e Google Cloud, consulta la panoramica dei server MCP di Google Cloud.

Endpoint server

Un endpoint di servizio MCP è l'indirizzo di rete e l'interfaccia di comunicazione (in genere un URL) del server MCP che un'applicazione AI (l'host per il client MCP) utilizza per stabilire una connessione sicura e standardizzata. È il punto di contatto per l'LLM per richiedere il contesto, chiamare uno strumento o accedere a una risorsa. Gli endpoint MCP di Google possono essere globali o regionali.

Il server MCP dell'API Gmail ha il seguente endpoint MCP globale:

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

Strumenti MCP

Uno strumento MCP è una funzione o una funzionalità eseguibile che un server MCP espone a un'applicazione LLM o AI per eseguire un'azione nel mondo reale.

Strumenti

Il server MCP gmailmcp.googleapis.com ha i seguenti strumenti:

Strumenti MCP
create_draft

Crea una nuova email in versione bozza nell'account Gmail dell'utente autenticato.

Questo strumento accetta come input gli indirizzi dei destinatari, un oggetto e il contenuto del corpo. Restituisce l'ID della bozza di Gmail creata.
list_drafts

Elenca le email in versione bozza dell'account Gmail dell'utente autenticato.

Questo strumento può filtrare le bozze in base a una stringa di query e supporta la paginazione. Restituisce un elenco di bozze, inclusi i relativi ID e oggetti.
get_thread Recupera uno specifico thread di email dall'account Gmail dell'utente autenticato, incluso un elenco dei relativi messaggi.
search_threads

Elenca i thread di 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 i corpi dei messaggi completi non vengono restituiti da questo strumento; se necessario, utilizza lo strumento "get_thread" con un ID thread per recuperare il corpo del messaggio completo.
label_thread

Aggiunge etichette a un intero thread nell'account Gmail dell'utente autenticato. Questa operazione interessa tutti i messaggi attualmente presenti nel thread e tutti i messaggi futuri aggiunti.

Se non conosci l'ID del thread, utilizza prima lo strumento search_threads.

Se non conosci l'ID di un'etichetta utente, utilizza prima lo strumento list_labels per scoprire le etichette disponibili e i relativi ID.
unlabel_thread Rimuove le etichette da un intero thread nell'account Gmail dell'utente autenticato. Se non conosci l'ID del thread, utilizza prima lo strumento search_threads. Se non conosci l'ID di un'etichetta utente, utilizza prima lo strumento list_labels.
list_labels Elenca tutte le etichette definite dall'utente disponibili nell'account Gmail dell'utente autenticato. Utilizza questo strumento per scoprire il id di un'etichetta utente prima di chiamare label_thread, unlabel_thread, label_message o unlabel_message. Le etichette di sistema non vengono restituite da questo strumento, ma possono essere utilizzate con i relativi ID noti: "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT".
label_message

Aggiunge una o più etichette a un messaggio specifico nell'account Gmail dell'utente autenticato.

Per trovare l'ID del messaggio, utilizza strumenti come search_threads o get_thread. Se non conosci l'ID di un'etichetta utente, utilizza prima lo strumento list_labels per scoprire le etichette disponibili e i relativi ID.
unlabel_message Rimuove una o più etichette da un messaggio specifico nell'account Gmail dell'utente autenticato. Per trovare l'ID del messaggio, utilizza strumenti come search_threads o get_thread. Se non conosci l'ID di un'etichetta utente, utilizza prima lo strumento list_labels per scoprire le etichette disponibili e i relativi ID.
create_label Crea una nuova etichetta nell'account Gmail dell'utente autenticato.

Recuperare le specifiche degli strumenti MCP

Per recuperare le specifiche degli strumenti MCP per tutti gli strumenti in un server MCP, utilizza il metodo tools/list. L'esempio seguente mostra come utilizzare curl per elencare tutti gli strumenti e le relative specifiche attualmente disponibili nel server MCP.

Richiesta 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
}'