MCP Tools Reference: gmailmcp.googleapis.com

ツール: create_draft

認証済みユーザーの Gmail アカウントに新しい下書きメールを作成します。

このツールは、宛先アドレス、件名、本文の内容を入力として受け取ります。作成された Gmail の下書きの ID を返します。下書きが既存のメッセージへの返信として作成される場合は、元のメッセージの ID を replyToMessageId フィールドでツールに渡す必要があります。添付ファイル付きの下書きの作成はまだサポートされていません。

次のサンプルは、curl を使用して create_draft MCP ツールを呼び出す方法を示しています。

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

入力スキーマ

CreateDraft RPC に対するリクエスト メッセージ。

CreateDraftRequest

JSON 表現
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string
}
フィールド
to[]

string

必須。メールの下書きの主な受信者。各文字列は、有効なプレーン メールアドレス(例: "user@example.com")である必要があります。このツールでは「Name email@example.com」形式はサポートされていません。

cc[]

string

省略可。メールの下書きのカーボンコピーの受信者。各文字列は、有効なプレーン メールアドレス(例: "user@example.com")である必要があります。このツールでは「Name email@example.com」形式はサポートされていません。

bcc[]

string

省略可。メールの下書きのブラインド カーボンコピーの受取人。各文字列は、有効なプレーン メールアドレス(例: "user@example.com")である必要があります。このツールでは「Name email@example.com」形式はサポートされていません。

subject

string

省略可。メールの件名。指定しない場合、デフォルトは空になります。

body

string

省略可。メールの下書きの本文の主な内容。html_body も指定されている場合、このフィールドは書式なしテキストの代替として扱われます。

htmlBody

string

メールの下書きの HTML コンテンツ。指定すると、メールのリッチテキスト バージョンとして使用されます。

replyToMessageId

string

省略可。返信するメッセージの ID。指定すると、メールの下書きの返信先メッセージ ID として使用され、bodyhtml_body が元のメッセージ本文に追加されます。

出力スキーマ

下書きの詳細。

下書き

JSON 表現
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
フィールド
id

string

下書きリソースの固有識別子。

subject

string

下書きメッセージの件名。

threadId

string

この下書きが属するスレッドの ID。

toRecipients[]

string

ヘッダーから抽出された [宛先] の受信者のメールアドレスのリスト。

ccRecipients[]

string

ヘッダーから抽出された [Cc] の受信者のメールアドレスのリスト。

bccRecipients[]

string

ヘッダーから抽出された [Bcc] の受信者のメールアドレスのリスト。

plaintextBody

string

書式なしテキストの本文の内容(利用可能な場合)。

date

string

ISO 8601 形式(YYYY-MM-DD)の下書きの日付。

ツールのアノテーション

破壊的ヒント: ❌ | べき等ヒント: ❌ | 読み取り専用ヒント: ❌ | オープン ワールド ヒント: ❌