MCP Tools Reference: gmailmcp.googleapis.com

Narzędzie: get_thread

Pobiera określony wątek e-maili z konta Gmail uwierzytelnionego użytkownika, w tym listę wiadomości.

Poniższy przykład pokazuje, jak użyć narzędzia curl do wywołania narzędzia MCP get_thread.

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

Schemat wejściowy

Komunikat żądania dla RPC GetThread.

GetThreadRequest

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

string

Wymagane. Unikalny identyfikator wątku do pobrania.
messageFormat

enum (MessageFormat)

Opcjonalnie. Określa format wiadomości zwracanych w wątku. Domyślna wartość to FULL_CONTENT. Uwaga: jeśli potrzebujesz treści lub załączników, użyj FULL_CONTENT. W przypadku użycia MINIMAL pola plaintext_body i attachment_ids nie zostaną wypełnione. Jeśli nie masz pewności, jakiego formatu użyć, skorzystaj z domyślnego zachowania, używając FULL_CONTENT.

MessageFormat

Wyliczenie służące do kontrolowania poziomu 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 w „MINIMAL” oraz pełną treść każdej wiadomości.

Schemat wyjściowy

Wątek zawierający listę wiadomości.

Wątek

Zapis JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Pola
id

string

Unikalny identyfikator wątku.
messages[]

object (Message)

Lista wiadomości w wątku, uporządkowana chronologicznie.

Wiadomość

Zapis JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    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 w polu Do.
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.

Adnotacje narzędzia

Wskazówka dotycząca działania destrukcyjnego: ❌ | Wskazówka dotycząca działania idempotentnego: ✅ | Wskazówka dotycząca działania tylko do odczytu: ✅ | Wskazówka dotycząca działania w otwartym świecie: ❌