MCP Tools Reference: gmailmcp.googleapis.com

ツール: search_threads

認証されたユーザーの Gmail アカウントのメール スレッドを一覧表示します。

このツールは、クエリ文字列に基づいてスレッドをフィルタし、ページネーションをサポートしています。ID や関連するメッセージなど、スレッドのリストが返されます。各関連メッセージには、メッセージ本文のスニペット、件名、送信者、受信者などの詳細が含まれています。このツールではメッセージ本文全体は返されません。必要に応じて、スレッド ID を指定して get_thread ツールを使用し、メッセージ本文全体を取得してください。

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

入力スキーマ

SearchThreads RPC のリクエスト メッセージ。

SearchThreadsRequest

JSON 表現 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
フィールド

共用体フィールド _page_size。

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

integer

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

共用体フィールド _page_token。

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

string

省略可。リスト内の結果の特定のページを取得するためのページトークン。最初のページを取得するには、空欄のままにします。

共用体フィールド _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"

共用体フィールド _include_trash。

_include_trash は次のいずれかになります。
includeTrash

boolean

省略可。ゴミ箱のドラフトを結果に含めます。デフォルトは false です。

出力スキーマ

SearchThreads RPC のレスポンス メッセージ。

SearchThreadsResponse

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

object (Thread)

スレッドの概要のリスト。
nextPageToken

string

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

スレッド

JSON 表現 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
フィールド
id

string

スレッドの一意の識別子。
messages[]

object (Message)

スレッド内のメッセージのリスト（時系列順）。

メッセージ

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

string

メッセージの一意の識別子。
snippet

string

メッセージ本文のスニペット。
subject

string

ヘッダーから抽出されたメッセージの件名:
sender

string

送信者のメールアドレス。
toRecipients[]

string

受信者のメールアドレス。
ccRecipients[]

string

CC 受信者のメールアドレス。
date

string

メッセージの日付（ISO 8601 形式（YYYY-MM-DD））。
plaintextBody

string

本文のコンテンツ全体。MessageFormat が FULL_CONTENT の場合にのみ設定されます。

ツールのアノテーション

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