gmail-unread

shiiman's avatarfrom shiiman

Gmail の未読メッセージ一覧を取得する。「未読メール」「Gmail 未読」「未読一覧」「未読メールを見たい」「未読メッセージ」「メールの未読」「全アカウントの未読」などで起動。

0stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026

When & Why to Use This Skill

The gmail-unread skill enables Claude to efficiently retrieve and list unread messages from a user's Gmail accounts. It provides essential email metadata such as message IDs, subjects, senders, and timestamps, allowing for seamless inbox monitoring and triage directly within the AI workflow. It supports multi-profile management and customizable fetch limits to handle high-volume inboxes effectively.

Use Cases

  • Inbox Triage: Quickly scan subject lines and senders of unread emails to identify and prioritize urgent tasks without leaving the chat interface.
  • Multi-Account Monitoring: Consolidate unread message lists from all connected Google profiles to get a unified view of pending communications.
  • Workflow Automation: Use as a preliminary step to identify specific emails that need to be read in full or marked as read using related Gmail skills.
  • Daily Briefing: Generate a concise summary of new incoming mail at the start of the workday to stay organized and responsive.
namegmail-unread
descriptionGmail の未読メッセージ一覧を取得する。「未読メール」「Gmail 未読」「未読一覧」「未読メールを見たい」「未読メッセージ」「メールの未読」「全アカウントの未読」などで起動。
allowed-tools[Read, Bash]

Gmail Unread

Gmail の未読メッセージ一覧を取得します。

実行方法

アクティブプロファイルの未読一覧

python plugins/shiiman-google/skills/gmail-unread/scripts/google_gmail.py unread

最大件数を指定

python plugins/shiiman-google/skills/gmail-unread/scripts/google_gmail.py unread --max 50

全プロファイルの未読一覧

python plugins/shiiman-google/skills/gmail-unread/scripts/google_gmail.py unread-all

未読が100件を超えるか確認

python plugins/shiiman-google/skills/gmail-unread/scripts/google_gmail.py unread-all --show-has-more

JSON 形式で出力

python plugins/shiiman-google/skills/gmail-unread/scripts/google_gmail.py --format json unread

出力項目

  • id: メッセージID
  • subject: 件名
  • from: 送信者
  • date: 受信日時

追加取得について

デフォルトでは最大100件を取得します。

追加取得の確認方法

--show-has-more オプションを使用すると、指定した件数(デフォルト100件)を超える未読があるかどうかが表示されます。 出力に「※ まだ未読があります」と表示された場合は、ユーザーに追加取得するか確認してください。

追加取得の実行方法

続きを取得する場合は --max 200 のように件数を増やして再実行します。

関連操作

  • 本文を読む: メッセージID を指定して gmail-read を実行
  • 既読にする: gmail-mark-read を実行