MCP Tools Reference: gmailmcp.googleapis.com

Narzędzie: list_drafts

Wyświetla listę e-maili w wersji roboczej z konta Gmail uwierzytelnionego użytkownika.

To narzędzie może filtrować wersje robocze na podstawie ciągu zapytania i obsługuje stronicowanie. Zwraca listę wersji roboczych, w tym ich identyfikatory i tematy.

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

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

Schemat wejściowy

Wiadomość z prośbą o wywołanie RPC ListDrafts.

ListDraftsRequest

Zapis JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
Pola

Pole zbiorcze _page_size.

Pole _page_size może mieć tylko jedną z tych wartości:
pageSize

integer

Opcjonalnie. Maksymalna liczba zwracanych wersji roboczych. Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wartość 20. Maksymalna dozwolona wartość to 50.

Pole zbiorcze _page_token.

Pole _page_token może mieć tylko jedną z tych wartości:
pageToken

string

Opcjonalnie. Token otrzymany z poprzedniego wywołania list_drafts, który umożliwia pobranie następnej strony wyników. Aby pobrać pierwszą stronę, pozostaw to pole puste.

Pole zbiorcze _query.

Pole _query może mieć tylko jedną z tych wartości:
query

string

Opcjonalnie. Ciąg zapytania do filtrowania wersji roboczych w tym samym formacie co pasek wyszukiwania w Gmailu. Jeśli ten parametr zostanie pominięty, wyświetlone zostaną wszystkie wersje robocze (z wyjątkiem spamu i kosza). Kluczowe operatory: from: – wiadomości od określonego nadawcy. do: – wiadomości wysłane do określonego odbiorcy. subject: – wiadomości zawierające określone słowa w temacie. - Wiadomości zawierające określone słowa w treści lub temacie. is:unread - Nieprzeczytane wiadomości. is:starred - Wiadomości oznaczone gwiazdką. has:attachment - Wiadomości z załącznikami. after:RRRR/MM/DD – wiadomości wysłane po określonej dacie. before:RRRR/MM/DD – wiadomości wysłane przed określoną datą. newer_than: „” – wyszukaj dokładną frazę.

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

Schemat wyjściowy

Wiadomość z odpowiedzią na wywołanie RPC ListDrafts.

ListDraftsResponse

Zapis JSON 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string
}
Pola
drafts[]

object (Draft)

Lista wersji roboczych.
nextPageToken

string

Token, którego można użyć w kolejnym wywołaniu, aby pobrać następną stronę wersji roboczych. Wyświetlany tylko wtedy, gdy jest więcej wyników.

Wersja robocza

Zapis JSON 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
Pola
id

string

Unikalny identyfikator zasobu wersji roboczej.
subject

string

Wiersz tematu wersji roboczej wiadomości.
threadId

string

Identyfikator wątku, do którego należy ten projekt.
toRecipients[]

string

Lista adresów e-mail odbiorców w polu „Do” wyodrębnionych z nagłówków.
ccRecipients[]

string

Lista adresów e-mail odbiorców „DW” wyodrębnionych z nagłówków.
bccRecipients[]

string

Lista adresów e-mail odbiorców „UDW” wyodrębnionych z nagłówków.
plaintextBody

string

treść w formacie zwykłego tekstu, jeśli jest dostępna;
date

string

Data wersji roboczej w formacie ISO 8601 (RRRR-MM-DD).

Adnotacje narzędzi

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