MCP Tools Reference: gmailmcp.googleapis.com

ツール: create_draft

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

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

下書きメッセージの一意の ID（id）のみを返します。

制限事項: 添付ファイル付きの下書きの作成はまだサポートされていません。

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

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": "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,
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
フィールド
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 として使用され、body と html_body が元のメッセージ本文に追加されます。
attachments[]

object (Attachment)

省略可。メールに含める添付ファイル。メッセージ内の添付ファイルの合計サイズは 25 MB を超えることはできません。25 MB を超えるファイルを送信する必要がある場合は、まずファイルをドライブにアップロードしてから、ドライブのリンクを本文または html_body に挿入します。

添付ファイル

JSON 表現 
{
  "id": string,
  "filename": string,
  "mimeType": string,
  "content": string,
  "inline": boolean
}
フィールド
id

string

省略可。出力専用。存在する場合、別の GetMessageAttachment リクエストで取得できる外部添付ファイルの ID が含まれます。
filename

string

省略可。添付するファイルの名前（例: 「invoice.pdf」）。インライン添付ファイルの場合、これは Content-ID の生成に使用されます。通常の添付ファイルの場合、filename はメール クライアントにファイル名を指定するために使用されます。指定しない場合、添付ファイルは名前なしで受信されることがあります。
mimeType

string

省略可。コンテンツ タイプまたはメディア タイプを表すフィールドでは、IANA MIME タイプ（https://www.iana.org/assignments/media-types/media-types.xhtml）を使用する必要があります。指定しない場合、デフォルトは「application/octet-stream」です。
content

string (bytes format)

必須。添付ファイルの Base64 エンコードされたコンテンツ。

Base64 でエンコードされた文字列。
inline

boolean

省略可。true の場合、この添付ファイルはインラインとして処理されます。インライン添付ファイルとは、ダウンロード用の個別のファイルとしてリストされるのではなく、HTML メール本文内に表示されることを目的としたコンテンツです。false の場合、または存在しない場合は、デフォルトで false になり、通常の添付ファイルとして扱われます。

出力スキーマ

下書きの詳細。

ドラフト

JSON 表現 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string,
  "htmlBody": 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））。
htmlBody

string

下書きの HTML 本文コンテンツ（利用可能な場合）。

ツールのアノテーション

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

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.compose