mcpField
S
summarize-unread-emails

summarize-unread-emails

github.com/dalehurleyProductivity260 installsUpdated 36w ago
Repository

About summarize-unread-emails

summarize-unread-emails retrieves unread messages from the inbox and creates a categorized summary for email users reviewing pending mail. It organizes messages by category, sender, and recency, with counts and a timeline.

Key features

  1. 01Retrieve unread inbox messages
  2. 02Categorize by email type and sender
  3. 03Sort by received date
  4. 04Create summaries with counts and timeline

Use cases

  1. 01Review pending inbox messages
  2. 02Find unread emails by category or sender
  3. 03Identify recent messages and action items

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dalehurley/phpbot --skill summarize-unread-emails

After installing, type/summarize-unread-emailsin Claude Code to confirm it loaded.

Details

From the project README

Skill: summarize-unread-emails

Overview

This skill accesses your email inbox via AppleScript (macOS Mail) or email API to retrieve unread messages and generate a comprehensive summary organized by category, sender, and recency.

When to Use

Use this skill when the user asks to:

  • Summarize unread emails
  • Get an overview of unread messages
  • Organize or review inbox emails
  • See what emails are pending
  • Categorize unread messages by type or sender

Procedure

  1. Execute AppleScript to retrieve all unread messages from the inbox: osascript -e 'tell application "Mail" to set unreadMessages to (messages of inbox whose read status is false) | return count of unreadMessages'
  2. Extract email metadata (sender, subject, date received) for each unread message using AppleScript
  3. Parse and organize emails into logical categories (Development, Bills, Family, Shopping, Appointments, Professional, Marketing, Government, Other)
  4. Sort emails within each category by date received (most recent first)
  5. Generate a formatted summary report with category headers, email counts, and timeline breakdown
  6. Present summary to user with key insights and action items highlighted

Output

A formatted text summary organized by category and date, including sender, subject, and date received for each unread email. Includes category totals, timeline breakdown, and visual formatting with emojis for easy scanning.

Reference Commands

Commands for executing this skill (adapt to actual inputs):

osascript -e 'tell application "Mail" to set unreadMessages to (messages of inbox whose read status is false) | return count of unreadMessages'
osascript << 'EOF'
tell application "Mail"
    set unreadMessages to (messages of inbox whose read status is false)
    repeat with msg in unreadMessages
        set output to output & "From: " & (sender of msg) & return & "Subject: " & (subject of msg) & return & "Date: " & (date received of msg) & return & return
    end repeat
end tell
EOF

Replace {{PLACEHOLDER}} values with actual credentials from the key store.

Example

Example requests that trigger this skill:

summarize my unread emails

Notes

  • This skill uses AppleScript and requires Mail.app to be running on macOS
  • Large numbers of unread emails (100+) may take several seconds to process
  • Emails are categorized based on subject line keywords and sender domain analysis
  • The summary is generated locally and not stored or transmitted externally

Keywords

unread, inbox, email summary, organize emails, pending messages, email overview

Comments

Markdown supported