MCP Tools Reference: gmailmcp.googleapis.com

Strumento: get_message

Recupera un messaggio email specifico dall'account Gmail dell'utente autenticato in base al suo ID messaggio univoco.

Utilizza questo strumento per esaminare una singola email quando ne conosci già l'ID messaggio. Se l'utente vuole leggere in dettaglio un'email specifica, controllare la formulazione esatta di un messaggio o esaminare i metadati degli allegati di una singola email, questo è lo strumento giusto. Non è adatto per recuperare intere conversazioni o visualizzare thread di discussione avanti e indietro; utilizza invece lo strumento "get_thread". Gli indicatori chiave includono se l'utente chiede il contenuto completo di un ID messaggio specifico restituito da una ricerca precedente o se la query chiede di esaminare una singola email specifica anziché un intero thread. Esempi di prompt utente sono: "Get the full text of message ID 18f123456789abcd.", "Read the latest message in that thread from Alice." e "What are the attachment names in the email I just received from HR?"

Il parametro facoltativo messageFormat controlla il formato del messaggio restituito. Per impostazione predefinita (o con FULL_CONTENT), restituisce il contenuto completo del messaggio. Utilizza MINIMAL per includere solo l'oggetto e lo snippet (escluso il corpo). Utilizza METADATA_ONLY per includere solo i metadati di base (ID messaggio, ID thread, etichette, timestamp e stima delle dimensioni).

I seguenti esempi mostrano come utilizzare curl per richiamare lo strumento MCP get_message.

Richiesta curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_message",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio di richiesta per GetMessage RPC.

GetMessageRequest

Rappresentazione JSON 
{
  "messageId": string,
  "messageFormat": enum (MessageFormat)
}
Campi
messageId

string

Obbligatorio. L'identificatore univoco del messaggio da recuperare.
messageFormat

enum (MessageFormat)

Facoltativo. Specifica il formato del messaggio restituito. Il valore predefinito è FULL_CONTENT.

MessageFormat

Enum per controllare il livello di dettaglio dei messaggi nel thread.

Enum
MESSAGE_FORMAT_UNSPECIFIED Il valore predefinito è FULL_CONTENT.
MINIMAL Restituisce snippet di messaggi e intestazioni chiave (Oggetto, Da, A, Cc, Data).
FULL_CONTENT Restituisce tutte le informazioni in "MINIMAL" più il contenuto completo del corpo di ogni messaggio.
METADATA_ONLY Solo metadati: non include oggetto, snippet, corpo, nomi di file degli allegati.

Schema di output

Messaggio all'interno di un thread.

Message

Rappresentazione JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    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

Indirizzi email dei destinatari.
ccRecipients[]

string

Indirizzi email dei destinatari in Cc.
date

string

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

string

Contenuto completo del corpo, compilato solo se MessageFormat era FULL_CONTENT.
attachmentIds[]

string

Solo output. Gli ID degli allegati, compilati solo se MessageFormat era FULL_CONTENT.
htmlBody

string

Il contenuto HTML dell'email, compilato solo se MessageFormat era FULL_CONTENT.
attachments[]

object (AttachmentMetadata)

Solo output. Gli allegati, compilati solo se MessageFormat era FULL_CONTENT.
labelIds[]

string

Gli ID delle etichette allegate al messaggio. Include gli ID delle etichette utente e delle etichette di sistema standard limitate a INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT.

AttachmentMetadata

Rappresentazione JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Campi
id

string

Solo output. L'ID dell'allegato.
mimeType

string

Il tipo MIME dell'allegato.
filename

string

Il nome file dell'allegato.

Annotazioni dello strumento

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

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata