| name | stats |
| description | This skill should be used when the user asks for "email stats", "inbox stats", "email analytics", "how many unread", or wants to see inbox metrics. Shows unread count, top senders, oldest unread, and volume trends. |
| triggers | ["email stats","inbox stats","email analytics","how many unread","email summary"] |
/email:stats - Inbox Statistics
Get a quick overview of your inbox: unread count, volume, top senders, and oldest unread.
Usage
/email:stats # Current inbox snapshot
/email:stats --weekly # Include week-over-week comparison
/email:stats --folder Sent # Stats for a specific folder
When Invoked
- Call
list_emails with page_size: 50 to get recent emails
- Call
search_emails with not flag Seen to get unread count
- Compute statistics from the results:
- Total unread count
- Today's email count
- Yesterday's email count
- Top senders (by frequency in recent emails)
- Oldest unread email (date and sender)
- If
--weekly flag: call list_emails for previous week and compare
- Display formatted statistics
MCP Tools Used
list_emails — to get recent envelopes and countssearch_emails — to filter by unread status and date ranges
Output Format
📊 Inbox Stats
Unread: 47 (12 today, 8 yesterday)
Total recent: 156 emails (last 7 days)
Top senders:
1. boss@company.com — 6 emails
2. team@company.com — 4 emails
3. newsletter@dev.to — 3 emails
4. github@notifications — 3 emails
5. ci@builds.io — 2 emails
Oldest unread: 12 days ago
From: hr@company.com
Subject: Benefits enrollment deadline
→ "Read oldest unread" to view it
→ "/email:triage" to classify unread
→ "/email:manage archive" to bulk archive
Weekly Comparison (--weekly)
📊 Inbox Stats (Weekly)
This week Last week Change
Received: 47 52 ↓ 10%
Unread: 12 8 ↑ 50%
Sent: 23 19 ↑ 21%
Top senders this week:
1. boss@company.com — 6 emails
...
→ Unread trending up — consider /email:triage
