MCP Tools Reference: gmailmcp.googleapis.com

Narzędzie: create_draft

Tworzy nową wersję roboczą e-maila na koncie Gmail uwierzytelnionego użytkownika.

To narzędzie przyjmuje jako dane wejściowe adresy odbiorców, temat i treść wiadomości. Zwraca identyfikator utworzonej wersji roboczej w Gmailu. Jeśli wersja robocza jest tworzona jako odpowiedź na istniejącą wiadomość, identyfikator oryginalnej wiadomości należy przekazać do narzędzia w polu replyToMessageId. Tworzenie wersji roboczych z załącznikami nie jest jeszcze obsługiwane.

Poniższy przykład pokazuje, jak użyć narzędzia curl do wywołania narzędzia MCP create_draft.

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

Schemat wejściowy

Wiadomość żądania dla RPC CreateDraft.

CreateDraftRequest

Zapis JSON 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string
}
Pola
to[]

string

Wymagane. Główni odbiorcy wersji roboczej e-maila. Każdy ciąg znaków MUSI być prawidłowym adresem e-mail (np. „user@example.com”). To narzędzie NIE obsługuje formatu „Name email@example.com”.
cc[]

string

Opcjonalnie. Odbiorcy wersji roboczej e-maila w polu „DW”. Każdy ciąg znaków MUSI być prawidłowym adresem e-mail (np. „user@example.com”). To narzędzie NIE obsługuje formatu „Name email@example.com”.
bcc[]

string

Opcjonalnie. Odbiorcy wersji roboczej e-maila w polu „UDW”. Każdy ciąg znaków MUSI być prawidłowym adresem e-mail (np. „user@example.com”). To narzędzie NIE obsługuje formatu „Name email@example.com”.
subject

string

Opcjonalnie. Temat e-maila. Jeśli nie zostanie podany, domyślnie będzie pusty.
body

string

Opcjonalnie. Główna treść wersji roboczej e-maila. Jeśli podano też html_body, to pole jest traktowane jako alternatywa w postaci zwykłego tekstu.
htmlBody

string

Zawartość HTML wersji roboczej e-maila. Jeśli zostanie podana, będzie używana jako wersja e-maila w formacie RTF.
replyToMessageId

string

Opcjonalnie. Identyfikator wiadomości, na którą chcesz odpowiedzieć. Jeśli zostanie podany, będzie używany jako identyfikator wiadomości, na którą chcesz odpowiedzieć, w wersji roboczej e-maila, a pola body i html_body zostaną dołączone do treści oryginalnej wiadomości.

Schemat wyjściowy

Szczegóły wersji roboczej.

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

Temat wersji roboczej wiadomości.
threadId

string

Identyfikator wątku, do którego należy ta wersja robocza.
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 w polu „DW” wyodrębnionych z nagłówków.
bccRecipients[]

string

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

string

Treść w postaci zwykłego tekstu, jeśli jest dostępna.
date

string

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

Adnotacje narzędzia

Wskazówka dotycząca działania destrukcyjnego: ❌ | Wskazówka dotycząca idempotentności: ❌ | Wskazówka dotycząca trybu tylko do odczytu: ❌ | Wskazówka dotycząca otwartego świata: ❌