gmail

Gmail メール管理

このスキルでは、Gmail のメール、ラベル、整理方法を包括的に説明します。

要件

• Hyper MCP がインストールされ、接続されていること。 https://app.hyperfx.ai/mcp
• https://app.hyperfx.ai/apps で Gmail 統合 が有効になっていること。

このスキルのツールの実行方法

このスキルの各ツールには、正式なツール名が付いています。利用するインターフェイスから指定される呼び出し方法で実行してください。

インターフェイス	ツールを探す	実行する
MCP クライアント（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>") を実行し、続けて describe("<name>") を実行します	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>" を実行し、続けて hyperai describe <name> を実行します	hyperai call <name> --json '{...}'

ツールが見つからない場合、その統合がワークスペースに接続されていないか、有効になっていません。処理を中止し、接続する必要がある統合をユーザーに伝えてください。

ラベル操作 — 重要な違い

ラベルを追加（メールを現在の場所に残したまま、新しいラベルを追加）

• 使用するツール：gmail_labels_add
• 使用例：メールを現在の場所から移動せずにラベルを追加する場合
• 例：メールは INBOX に残り、「Important」ラベルも付きます

ラベルに移動（INBOX から削除し、対象のラベルを追加）

• 使用するツール：gmail_messages_move_to_label
• 使用例：メールを受信トレイから特定のラベル／フォルダーに移動する場合
• 例：メールが INBOX から削除され、「Archive」または「Work」に移動します
• 次の 2 つの操作を実行します：INBOX ラベルを削除し、対象のラベルを追加します

ラベルを削除（指定したラベルを削除）

• 使用するツール：gmail_labels_remove
• 使用例：メールからラベルを削除する場合
• INBOX を含む、任意のラベルを削除できます

ラベル ID の取得

重要：多くの Gmail ラベル操作では、ラベル名ではなくラベル ID が必要です。

• 利用可能なラベルとその ID を取得するため、必ず最初に gmail_labels_list を呼び出してください
• ラベル ID の例：「Label_123」、「Label_456」、またはシステムラベル：「INBOX」、「SENT」、「TRASH」
• ラベル ID を推測したり、作り出したりしないでください

よくあるワークフロー

メールの振り分け／整理

1. 利用可能なラベルを確認するため、gmail_labels_list を呼び出します
2. メールを取得するため、gmail_messages_list を呼び出します
3. gmail_messages_move_to_label を使って、メールを INBOX から適切なラベルに移動します

カテゴリの追加（受信トレイに残す）

1. ラベル ID を取得するため、gmail_labels_list を呼び出します
2. gmail_labels_add を使って、メールを INBOX に残したまま分類します

新しいラベルの作成

• 目的のラベルが存在しない場合は、gmail_labels_create を使います
• 作成したラベルの ID が返されるので、すぐに使用できます

メッセージの検索と一覧表示

gmail_messages_list は、Gmail の検索クエリ構文に完全対応しています。

• query パラメーターでは、Gmail の検索ボックスと同じ構文を使用できます
• 例：「is:unread」、「from:[email protected]」、「has:attachment subject:invoice」
• 演算子を組み合わせられます：「from:[email protected] is:unread has:attachment」
• デフォルトでは下書きを除外します（自動的に -in:draft が追加されます）
• 特定のラベルで絞り込むには、label パラメーターを使います

下書きのワークフロー

メールの下書きの作成と送信

1. gmail_drafts_create — 最初の下書きを作成します
2. gmail_drafts_update — 既存の下書きを編集します（任意）
3. gmail_drafts_send — 下書きをメールとして送信します

下書きの管理

• gmail_drafts_list — すべてのメールの下書きを一覧表示します
• gmail_drafts_get — ID を指定して特定の下書きを取得します
• gmail_drafts_delete — 送信せずに下書きを削除します

下書きと直接送信の使い分け

• 1 回の操作ですぐに送信する場合は、gmail_messages_send を使います
• 送信前に確認または編集する場合や、後で送信するようにスケジュールする場合は、下書きのワークフローを使います

メール操作 — 重要な違い

アーカイブとゴミ箱

• gmail_messages_archive — メールを INBOX から削除しますが、「すべてのメール」には残ります（復元可能で、削除されません）
• gmail_messages_trash — メールをゴミ箱フォルダーに移動します（30 日後に自動削除されます）
• メールを残したまま受信トレイを「整理」するには、アーカイブが推奨されます

添付ファイル

• gmail_attachments_get - 受信メールから添付ファイルをダウンロードします
• 添付ファイル付きのメールを送信する場合は、file_ids パラメーターを使用します（事前にファイルをデータベースに登録しておく必要があります）

ツール選択クイックリファレンス

アクション	ツール
X ラベルを追加	gmail_labels_add
X ラベルに移動	gmail_messages_move_to_label
受信トレイから削除	gmail_messages_move_to_label（移動先を指定）または gmail_labels_remove（INBOX のみを削除）
メールをアーカイブ	gmail_messages_archive（整理する場合に推奨）
メールを削除／ゴミ箱に移動	gmail_messages_trash
メールを今すぐ送信	gmail_messages_send
後で送信するメールを作成	gmail_drafts_create + gmail_drafts_send