MCP Tools Reference: gmailmcp.googleapis.com

Strumento: list_drafts

Elenca le bozze di email 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 ID e oggetto. page_token può essere utilizzato per impaginare i risultati. Per recuperare le pagine successive dei risultati, utilizza page_token restituito nella risposta precedente.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP list_drafts.

Curl Request 
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": "list_drafts",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio di richiesta per la RPC ListDrafts.

ListDraftsRequest

Rappresentazione JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
Campi

Campo unione _page_size.

_page_size può essere solo uno dei seguenti tipi:
pageSize

integer

Facoltativo. Il numero massimo di bozze da restituire. Se non specificato, il valore predefinito è 20. Il valore massimo consentito è 50.

Campo unione _page_token.

_page_token può essere solo uno dei seguenti tipi:
pageToken

string

Facoltativo. Un token ricevuto da una precedente chiamata list_drafts per recuperare la pagina successiva dei risultati. Lascia vuoto per recuperare la prima pagina. Viene utilizzato principalmente per la paginazione per continuare a recuperare i risultati dal punto in cui si è interrotta la chiamata ListDraft precedente, soprattutto quando il numero di bozze corrispondenti alla query supera il limite di page_size.

Campo unione _query.

_query può essere solo uno dei seguenti tipi:
query

string

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

Uno spazio o un trattino (-) separeranno un numero, mentre un punto (.) sarà un decimale. Ad esempio, 01.2047-100 viene considerato come due numeri: 01.2047 e 100.

Nota: se vogliamo assicurarci che vengano restituiti tutti i draft per la query, possiamo paginare i risultati effettuando chiamate ripetute allo strumento finché la risposta non contiene un elenco vuoto di bozze.

Schema di output

Messaggio di risposta per la RPC ListDrafts.

ListDraftsResponse

Rappresentazione JSON 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string
}
Campi
drafts[]

object (Draft)

Elenco delle bozze.
nextPageToken

string

Un token che può essere utilizzato in una chiamata successiva per recuperare la pagina successiva delle bozze. Se il numero di bozze corrispondenti alla query supera il limite di page_size, la risposta conterrà un next_page_token. Per recuperare la pagina successiva dei risultati, passa questo token nel campo page_token della successiva ListDraftsRequest.

Bozza

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

string

L'identificatore univoco della risorsa bozza.
subject

string

La riga dell'oggetto della bozza del messaggio.
threadId

string

L'ID del thread a cui appartiene questa bozza.
toRecipients[]

string

Elenco degli indirizzi email dei destinatari "A" estratti dalle intestazioni.
ccRecipients[]

string

Elenco degli indirizzi email dei destinatari in "Cc" estratti dalle intestazioni.
bccRecipients[]

string

Elenco degli indirizzi email dei destinatari in "Ccn" estratti dalle intestazioni.
plaintextBody

string

Contenuto del corpo del messaggio in testo normale, se disponibile.
date

string

Data della bozza nel formato ISO 8601 (AAAA-MM-GG).

Annotazioni dello strumento

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