MCP Tools Reference: gmailmcp.googleapis.com

ツール: list_drafts

認証されたユーザーの Gmail アカウントの下書きメールを一覧表示します。

このツールでは、クエリ文字列に基づいて下書きをフィルタし、ページネーションをサポートできます。ID や件名など、下書きのリストが返されます。

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

Curl リクエスト 
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": "list_drafts",
    "arguments": {
      // provide these details according to the tool 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 呼び出しから受け取ったトークン。最初のページを取得するには、空欄のままにします。

共用体フィールド _query。

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

string

省略可。Gmail 検索バーと同じ形式で下書きをフィルタするクエリ文字列。省略すると、すべての下書き（デフォルトではスパムとゴミ箱を除く）が一覧表示されます。主な演算子: from: - 特定の送信者からのメッセージ。 to: - 特定の受信者に送信されたメッセージ。subject: - 件名に特定の語句が含まれるメッセージ。 - 本文または件名に特定の単語を含むメール。is:unread - 未読のメール。is:starred - スター付きのメール。has:attachment - 添付ファイル付きのメール。after:YYYY/MM/DD - 特定の日付より後に送信されたメッセージ。before:YYYY/MM/DD - 特定の日付より前に送信されたメッセージ。newer_than:

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

出力スキーマ

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

ListDraftsResponse

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

object (Draft)

下書きのリスト。
nextPageToken

string

下書きの次のページを取得するために、後続の呼び出しで使用できるトークン。結果が複数ある場合にのみ存在します。

下書き

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））。

ツールのアノテーション

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