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 i relativi ID e oggetti (a meno che view non sia impostato su DRAFT_VIEW_METADATA_ONLY). page_token può essere utilizzato per paginare i risultati. Per recuperare le pagine successive dei risultati, utilizza il page_token restituito nella risposta precedente.

Il parametro view controlla quali campi vengono compilati nella risposta. Per impostazione predefinita (o con DRAFT_VIEW_FULL), restituisce i contenuti completi. Utilizza DRAFT_VIEW_METADATA_ONLY per escludere contenuti sensibili come l'oggetto e il corpo.

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

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": "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 l'RPC ListDrafts.

ListDraftsRequest

Rappresentazione JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "view": enum (DraftView)
}
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 è stata interrotta la chiamata ListDraft precedente, soprattutto quando il numero di bozze corrispondenti alla query supera il limite 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 restituite tutte le bozze per la query, possiamo paginare i risultati effettuando chiamate ripetute allo strumento finché la risposta non contiene un elenco vuoto di bozze.

Campo unione _view.

_view può essere solo uno dei seguenti tipi:
view

enum (DraftView)

Facoltativo. Controlla i campi compilati per le bozze nell'elenco delle bozze. Per impostazione predefinita (o con DRAFT_VIEW_FULL), restituisce i contenuti completi, che includono ID bozza, threadID, a, cc, ccn, data, oggetto e corpo. Utilizza DRAFT_VIEW_METADATA_ONLY per escludere l'oggetto e il corpo.

DraftView

Enum per controllare i campi compilati per le bozze nella risposta ListDrafts.

Enum
DRAFT_VIEW_UNSPECIFIED Esegue il mapping a DRAFT_VIEW_FULL per la compatibilità con le versioni precedenti.
DRAFT_VIEW_METADATA_ONLY Solo metadati: non include oggetto, plaintext_body, html_body.
DRAFT_VIEW_FULL Metadati + UGC (comportamento predefinito).

Schema di output

Messaggio di risposta per l'RPC ListDrafts.

ListDraftsResponse

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

object (Draft)

Elenco di 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 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.

Draft

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

string

L'identificatore univoco della risorsa bozza.
subject

string

La riga dell'oggetto del messaggio di bozza.
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 "Cc" estratti dalle intestazioni.
bccRecipients[]

string

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

string

Contenuto del corpo in testo normale, se disponibile.
date

string

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

string

Il contenuto del corpo HTML della bozza, se disponibile.

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.compose
  • https://www.googleapis.com/auth/gmail.readonly