MCP Tools Reference: gmailmcp.googleapis.com

ツール: list_drafts

認証済みユーザーの Gmail アカウントから下書きメールを一覧表示します。

このツールでは、クエリ文字列に基づいて下書きをフィルタリングでき、ページネーションをサポートしています。ID や件名など、下書きのリストを返します。page_token を使用して結果をページネーションできます。結果の次のページを取得するには、前のレスポンスで返された page_token を使用します。

次のサンプルは、curl を使用して list_drafts 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": "list_drafts",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

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

ListDraftsRequest

JSON 表現 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
フィールド

共用体フィールド _page_size。

_page_size は次のいずれかになります。
pageSize

integer

省略可。返す下書きの最大数。指定しない場合のデフォルトは 20 です。最大許容値は 50 です。

共用体フィールド _page_token。

_page_token は次のいずれかになります。
pageToken

string

省略可。結果の次のページを取得するために、前の list_drafts 呼び出しから受け取ったトークン。最初のページを取得するには、空のままにします。これは主にページネーションに使用され、特にクエリに一致する下書きの数が page_size の上限を超える場合に、前の ListDraft 呼び出しの続きから結果の取得を続行します。

共用体フィールド _query。

_query は次のいずれかになります。
query

string

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

スペースまたはハイフン（-）で数字を分割できます。ピリオド（.) は小数点を表します。たとえば、01.2047-100 は 01.2047 と 100 の 2 つの数字とみなされます。

注: クエリのすべてのドラフトが返されるようにするには、レスポンスにドラフトの空のリストが含まれるまで、ツールを繰り返し呼び出して結果をページネーションします。

出力スキーマ

ListDrafts RPC に対するレスポンス メッセージ。

ListDraftsResponse

JSON 表現 
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string
}
フィールド
drafts[]

object (Draft)

下書きのリスト。
nextPageToken

string

下書きの次のページを取得するために、後続の呼び出しで使用できるトークン。クエリに一致する下書きの数が page_size の上限を超える場合、レスポンスには next_page_token が含まれます。結果の次のページを取得するには、次の ListDraftsRequest の page_token フィールドにこのトークンを渡します。

下書き

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）の下書きの日付。

ツールのアノテーション

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