gmail

Gmail

利用可能なツール

• list_labels()：Gmail のすべてのラベルを一覧表示します（システムラベル：INBOX、SENT、TRASH、SPAM、DRAFT、IMPORTANT、STARRED、UNREAD、およびユーザー作成のラベル）。

• list_emails(label?, max_results?, include_spam_trash?)：ラベルでメールを一覧表示します。

  • label（string、任意、デフォルト："INBOX"）：フィルターに使用するラベル（INBOX、SENT、DRAFT、TRASH、SPAM、STARRED、IMPORTANT、またはカスタムラベル ID）
  • max_results（integer、任意、デフォルト：10、最大：100）：返すメールの数
  • include_spam_trash（boolean、任意、デフォルト：false）：SPAM と TRASH を含めるかどうか

• search_emails(query, max_results?)：検索クエリ構文を使って Gmail を検索します。

  • query（string、必須）：Gmail の検索クエリ（from:、to:、subject:、is:unread、has:attachment、after:、before:、older_than:、newer_than:）
  • max_results（integer、任意、デフォルト：10、最大：50）：結果の数

• read_email(message_id)：本文と添付ファイルを含むメール全体を読み取ります。

  • message_id（string、必須）：Gmail のメッセージ ID（list_emails または search_emails から取得）

• send_email(to, subject, body, cc?, bcc?, reply_to?, in_reply_to?, html_body?)：メールを送信します。

  • to（string、必須）：宛先（カンマ区切り）
  • subject（string、必須）：メールの件名
  • body（string、必須）：プレーンテキストのメール本文
  • cc（string、任意）：CC の宛先
  • bcc（string、任意）：BCC の宛先
  • reply_to（string、任意）：返信先アドレス
  • in_reply_to（string、任意）：返信先の Message-ID（スレッド化用）
  • html_body（string、任意）：メール本文の HTML 版

• draft_email(to, subject, body, cc?, bcc?, reply_to?, in_reply_to?, html_body?)：後で編集・送信するための下書きを作成します。パラメーターは send_email と同じです。

• delete_email(message_id, permanent?)：メールを削除します。

  • message_id（string、必須）：Gmail のメッセージ ID
  • permanent（boolean、任意、デフォルト：false）：true の場合は完全に削除し、false の場合はゴミ箱に移動します

• bulk_delete_emails(query, reason, max_delete?)：クエリに一致する複数のメールを完全に削除します。取り消せません。

  • query（string、必須）：削除するメールを検索する Gmail 検索クエリ
  • reason（string、必須）：ユーザーの承認を得る際に表示する、人が読める説明
  • max_delete（integer、任意、デフォルト：50、最大：100）：削除するメールの最大数

• modify_email(message_id, add_labels?, remove_labels?)：メールのラベルを追加または削除します。

  • message_id（string、必須）：Gmail のメッセージ ID
  • add_labels（string、任意）：追加するラベル ID（カンマ区切り、例："STARRED,IMPORTANT"）
  • remove_labels（string、任意）：削除するラベル ID（カンマ区切り、例："UNREAD,INBOX"）

• get_email_thread(thread_id)：メールスレッド／会話内のすべてのメッセージを取得します。

  • thread_id（string、必須）：Gmail のスレッド ID（read_email または search_emails から取得）

使用ガイドライン

• INBOX、SENT、DRAFT、TRASH、SPAM、STARRED、IMPORTANT などの標準ラベルには、list_emails を直接呼び出してください。カスタムラベルをユーザーが指定した場合、またはラベル名が不明な場合にのみ list_labels を使用してください。
• Gmail の検索クエリ構文：from:sender、to:recipient、subject:text、is:unread、has:attachment、after:2024/01/01、before:2024/12/31。
• 返信する前に会話全体のコンテキストを確認するには、get_email_thread を使用してください。

よく使う操作

modify_email によるラベル操作：

操作	パラメーター
既読にする	remove_labels="UNREAD"
未読にする	add_labels="UNREAD"
アーカイブ	remove_labels="INBOX"
スターを付ける	add_labels="STARRED"
スターを外す	remove_labels="STARRED"
重要マークを付ける	add_labels="IMPORTANT"

一括削除

bulk_delete_emails(query, reason) は、Gmail クエリに一致するすべてのメールを完全に削除します。取り消すことはできません。

• 意図を説明する reason パラメーターを必ず指定してください。
• 削除対象を必ず説明し、呼び出す前にユーザーの確認を得てください。

よく使われるクエリ：

• スパムの整理：「is:spam older_than:7d」
• 古い未読メール：「in:inbox is:unread older_than:14d」
• プロモーションの一括削除：「category:promotions older_than:30d」
• 特定の送信者からのメール：「from:[email protected] older_than:30d」

UI ガイダンス（tools-config より）

Gmail ツールの使い方：

• list_labels：指定されたラベルが不明な場合にカスタムラベルを確認します
• list_emails：ラベル（INBOX、SENT、DRAFT、TRASH など）でメールを参照します
• search_emails：Gmail のクエリ構文（from:、to:、subject:、is:unread、has:attachment、after:、before:）を使用します
• read_email：添付ファイルを含むメールの全文を取得します
• send_email：CC、BCC、HTML 本文をオプションで指定してメールを送信します
• draft_email：後で編集・送信するための下書きを作成します
• delete_email：ゴミ箱に移動します（完全に削除する場合は permanent=True）
• bulk_delete_emails：クエリに一致する複数のメールを完全に削除します（ユーザーの承認が必要です）
• modify_email：ラベルを追加・削除します（既読にする：UNREAD を削除、アーカイブする：INBOX を削除、スターを付ける：STARRED を追加）
• get_email_thread：会話スレッド全体を表示します

一括削除（bulk_delete_emails）：

• スパムの整理、古いメールの一括削除などに使用します
• 意図を説明する 'reason' パラメーターを必ず指定してください
• よく使われるクエリ：「is:spam older_than:7d」、「in:inbox is:unread older_than:14d」、「category:promotions older_than:30d」
• 警告：メールを完全に削除します。復元できません

よく使われる操作：

• 既読にする：modify_email(id, remove_labels="UNREAD")
• アーカイブする：modify_email(id, remove_labels="INBOX")
• スターを付ける：modify_email(id, add_labels="STARRED")
• 重要マークを付ける：modify_email(id, add_labels="IMPORTANT")