MCP Tools Reference: gmailmcp.googleapis.com

ツール: get_message

認証済みユーザーの Gmail アカウントから、固有のメッセージ ID を使用して特定のメール メッセージを取得します。

このツールは、メッセージ ID がわかっている単一のメールを検査する場合に使用します。ユーザーが特定のメールを詳しく読みたい場合、メッセージの正確な文言を確認したい場合、単一のメールの添付ファイルのメタデータを調べたい場合は、このツールが適しています。会話全体を取得したり、やり取りのスレッドを表示したりするのには適していません。代わりに 'get_thread' ツールを使用してください。重要な指標としては、ユーザーが以前の検索で返された特定のメッセージ ID の完全なコンテンツを要求しているかどうか、クエリがスレッド全体ではなく特定の個々のメールを検査するように要求しているかどうかなどがあります。ユーザーのプロンプトの例としては、「メッセージ ID 18f123456789abcd の全文を取得して」、「アリスからのスレッドの最新のメッセージを読んで」、「人事部から届いたメールの添付ファイルの名前は何？」などがあります。「そのスレッドの Alice からの最新のメッセージを読んで」や「人事から届いたメールの添付ファイルの名前を教えて」など。

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

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

入力スキーマ

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

GetMessageRequest

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

string

必須。取得するメッセージの固有識別子。
messageFormat

enum (MessageFormat)

省略可。返されるメッセージの形式を指定します。デフォルトは FULL_CONTENT です。

MessageFormat

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

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

出力スキーマ

スレッド内のメッセージ。

メッセージ

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