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.

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

Curl Request 
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
}'

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.

Campo unione _query.

_query può essere solo uno dei seguenti tipi:
query

string

Facoltativo. Una stringa di query per filtrare le bozze, utilizzando lo stesso formato della barra di ricerca di Gmail. Se omesso, vengono elencate tutte le bozze (esclusi spam e cestino per impostazione predefinita). Operatori chiave: from: - Messaggi inviati da un mittente specifico. a: - Messaggi inviati a un destinatario specifico. subject: - Messaggi con parole specifiche nell'oggetto. - Messaggi contenenti parole specifiche nel corpo o nell'oggetto. is:unread - Messaggi non letti. is:starred - Messaggi speciali. has:attachment - Messaggi con allegati. after:AAAA/MM/GG - Messaggi inviati dopo una data. before:AAAA/MM/GG - Messaggi inviati prima di una data. newer_than:

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

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. Presente solo se sono presenti altri risultati.

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 "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: ❌