MCP Tools Reference: gmailmcp.googleapis.com

Strumento: create_draft

Crea una nuova bozza di email nell'account Gmail dell'utente autenticato.

Questo strumento prende come input gli indirizzi dei destinatari, un oggetto e il contenuto del corpo. Restituisce l'ID della bozza di Gmail creata.

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

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

Schema di input

Messaggio di richiesta per la RPC CreateDraft.

CreateDraftRequest

Rappresentazione JSON 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string
}
Campi
to[]

string

Obbligatorio. I destinatari principali della bozza di email. Ogni stringa DEVE essere un indirizzo email valido (ad es. "utente@example.com"). Il formato "Nome email@example.com" NON è supportato da questo strumento.
cc[]

string

Facoltativo. I destinatari in copia carbone della bozza di email. Ogni stringa DEVE essere un indirizzo email valido (ad es. "utente@example.com"). Il formato "Nome email@example.com" NON è supportato da questo strumento.
bcc[]

string

Facoltativo. I destinatari della copia carbone nascosta della bozza di email. Ogni stringa DEVE essere un indirizzo email valido (ad es. "utente@example.com"). Il formato "Nome email@example.com" NON è supportato da questo strumento.
subject

string

Facoltativo. La riga dell'oggetto dell'email. Se non viene fornito, il valore predefinito è vuoto.
body

string

Facoltativo. Il corpo principale della bozza di email. Se viene fornito anche html_body, questo campo viene trattato come alternativa in testo normale.
htmlBody

string

Il contenuto HTML della bozza di email. Se fornito, verrà utilizzato come versione in formato RTF dell'email.

Schema di output

Dettagli di una bozza.

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