MCP Tools Reference: gmailmcp.googleapis.com

ツール: get_thread

認証済みユーザーの Gmail アカウントから特定のメール スレッドを取得します。これには、そのメッセージのリストが含まれます。

省略可能な messageFormat パラメータは、返されるメッセージの形式を制御します。デフォルト（または FULL_CONTENT）では、メッセージの完全なコンテンツが返されます。MINIMAL を使用すると、件名とスニペットのみが含まれます（本文は除外されます）。METADATA_ONLY を使用すると、基本的なメタデータ（メッセージ ID、スレッド ID、ラベル、タイムスタンプ、サイズの推定値）のみが含まれます。

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

入力スキーマ

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

GetThreadRequest

JSON 表現 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
フィールド
threadId

string

必須。取得するスレッドの一意の識別子。
messageFormat

enum (MessageFormat)

省略可。スレッド内で返されるメッセージの形式を指定します。デフォルトは FULL_CONTENT です。注: MINIMAL 形式では、id、snippet、subject、from、to、cc、date、labelIds が返されます。METADATA_ONLY 形式では、id、from、to、cc、date、labelIds が返されます。FULL_CONTENT では、id、snippet、subject、from、to、cc、date、labelIds、attachmentIds、plaintextBody、htmlBody、attachments が返されます。

MessageFormat

スレッド内のメッセージの詳細レベルを制御する列挙型。

列挙型
MESSAGE_FORMAT_UNSPECIFIED デフォルトは FULL_CONTENT です。
MINIMAL メッセージ スニペットと主要なヘッダー（件名、From、To、Cc、Date）を返します。
FULL_CONTENT 「MINIMAL」のすべての情報に加えて、各メッセージの本文の完全なコンテンツを返します。
METADATA_ONLY メタデータのみ: 件名、スニペット、本文、添付ファイルのファイル名は含まれません。

出力スキーマ

メッセージのリストを含むスレッド。

スレッド

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,
  "attachmentIds": [
    string
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    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 の場合にのみ入力されます。
attachmentIds[]

string

出力専用。添付ファイルの ID。MessageFormat が FULL_CONTENT の場合にのみ入力されます。
htmlBody

string

メールの HTML コンテンツ。MessageFormat が FULL_CONTENT の場合にのみ入力されます。
attachments[]

object (AttachmentMetadata)

出力専用。添付ファイル。MessageFormat が FULL_CONTENT の場合にのみ入力されます。
labelIds[]

string

メッセージに添付されたラベルの ID。ユーザーラベルの ID と、INBOX、SPAM、TRASH、UNREAD、STARRED、IMPORTANT、SENT、DRAFT、CHAT に限定された標準システムラベルの ID が含まれます。

AttachmentMetadata

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

string

出力専用。添付ファイルの ID。
mimeType

string

添付ファイルの MIME タイプ。
filename

string

添付ファイルのファイル名。

ツールのアノテーション

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

認可スコープ

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

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