MCP Tools Reference: gmailmcp.googleapis.com

Narzędzie: get_message

Pobiera konkretną wiadomość e-mail z konta Gmail uwierzytelnionego użytkownika na podstawie jej unikalnego identyfikatora.

Użyj tego narzędzia, aby sprawdzić pojedynczy e-mail, jeśli znasz już jego identyfikator. Jeśli użytkownik chce szczegółowo przeczytać konkretnego e-maila, sprawdzić dokładne sformułowanie wiadomości lub zbadać metadane załącznika do pojedynczego e-maila, to narzędzie jest dla niego odpowiednie. Nie nadaje się do pobierania całych rozmów ani wyświetlania wątków dyskusji. Zamiast tego użyj narzędzia „get_thread”. Kluczowe wskaźniki to m.in. to, czy użytkownik prosi o pełną treść konkretnego identyfikatora wiadomości zwróconego przez poprzednie wyszukiwanie, lub czy zapytanie dotyczy sprawdzenia konkretnego e-maila, a nie całego wątku. Przykładowe prompty użytkownika: „Pobierz pełny tekst wiadomości o identyfikatorze 18f123456789abcd”. „Przeczytaj najnowszą wiadomość w tym wątku od Alicji” i „Jakie są nazwy załączników w e-mailu, który właśnie otrzymałem od działu HR?”.

Opcjonalny parametr messageFormat określa format zwracanej wiadomości. Domyślnie (lub w przypadku użycia parametru FULL_CONTENT) zwraca pełną treść wiadomości. Użyj MINIMAL, aby uwzględnić tylko temat i fragment (z wyłączeniem treści). Użyj METADATA_ONLY, aby uwzględnić tylko podstawowe metadane (identyfikator wiadomości, identyfikator wątku, etykiety, sygnaturę czasową i szacowany rozmiar).

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie get_message MCP.

Żądanie 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
}'

Schemat danych wejściowych

Wiadomość żądania dla wywołania RPC GetMessage.

GetMessageRequest

Zapis JSON 
{
  "messageId": string,
  "messageFormat": enum (MessageFormat)
}
Pola
messageId

string

Wymagane. Unikalny identyfikator wiadomości do pobrania.
messageFormat

enum (MessageFormat)

Opcjonalnie. Określa format zwracanej wiadomości. Domyślna wartość to FULL_CONTENT.

MessageFormat

Wyliczenie określające poziom szczegółowości wiadomości w wątku.

Wartości w polu enum
MESSAGE_FORMAT_UNSPECIFIED Domyślna wartość to FULL_CONTENT.
MINIMAL Zwraca fragmenty wiadomości i kluczowe nagłówki (Temat, Od, Do, DW, Data).
FULL_CONTENT Zwraca wszystkie informacje z poziomu „MINIMAL” oraz pełną treść każdej wiadomości.
METADATA_ONLY Tylko metadane: nie obejmuje tematu, fragmentu, treści ani nazw plików załączników.

Schemat wyjściowy

Wiadomość w wątku.

Wiadomość

Zapis 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
  ]
}
Pola
id

string

Unikalny identyfikator wiadomości.
snippet

string

Fragment treści wiadomości.
subject

string

Temat wiadomości wyodrębniony z nagłówków:
sender

string

Adres e-mail nadawcy.
toRecipients[]

string

Adresy e-mail odbiorców.
ccRecipients[]

string

Adresy e-mail odbiorców w polu DW.
date

string

Data wiadomości w formacie ISO 8601 (RRRR-MM-DD).
plaintextBody

string

Pełna treść, wypełniana tylko wtedy, gdy MessageFormat ma wartość FULL_CONTENT.
attachmentIds[]

string

Tylko dane wyjściowe. Identyfikatory załączników, wypełniane tylko wtedy, gdy MessageFormat ma wartość FULL_CONTENT.
htmlBody

string

Zawartość HTML e-maila. Wypełniana tylko wtedy, gdy MessageFormat ma wartość FULL_CONTENT.
attachments[]

object (AttachmentMetadata)

Tylko dane wyjściowe. Załączniki, wypełniane tylko wtedy, gdy MessageFormat ma wartość FULL_CONTENT.
labelIds[]

string

Identyfikatory etykiet dołączonych do wiadomości. Zawiera identyfikatory etykiet użytkownika i standardowych etykiet systemowych, które są ograniczone do INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT.

AttachmentMetadata

Zapis JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Pola
id

string

Tylko dane wyjściowe. Identyfikator załącznika.
mimeType

string

Typ MIME załącznika.
filename

string

Nazwa pliku załącznika.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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