Morning Email Rollup

Automatically generates a daily summary of important emails and delivers it to Telegram at 8am Denver time.

Setup

Required: Set your Gmail account email:

export GOG_ACCOUNT="your-email@gmail.com"

Or edit the script directly to set the default.

What It Does

Runs every day at 8:00 AM (configurable timezone)
Shows today's calendar events from Google Calendar
Searches for emails marked as important or starred from the last 24 hours
Uses AI (Gemini CLI) to generate natural language summaries of each email
Shows up to 20 most important emails with:
- 🔴 Unread indicator (red)
- 🟢 Read indicator (green)
- Sender name/email
- Subject line
- AI-generated 1-sentence summary (natural language, not scraped content)
Delivers formatted summary to Telegram

Usage

Manual Run

# Default (10 emails)
bash skills/morning-email-rollup/rollup.sh

# Custom number of emails
MAX_EMAILS=20 bash skills/morning-email-rollup/rollup.sh
MAX_EMAILS=5 bash skills/morning-email-rollup/rollup.sh

View Log

cat $HOME/clawd/morning-email-rollup-log.md

How It Works

Checks calendar - Lists today's events from Google Calendar via gog
Searches Gmail - Query: is:important OR is:starred newer_than:1d
Fetches details - Gets sender, subject, date, and body for each email
AI Summarization - Uses Gemini CLI to generate natural language summaries
Formats output - Creates readable summary with read/unread markers
Sends to Telegram - Delivers via Clawdbot's messaging system

Calendar Integration

The script automatically includes today's calendar events from your Google Calendar using the same gog CLI that queries Gmail.

Graceful Fallback:

If gog is not installed → Calendar section is silently skipped (no errors)
If no events today → Calendar section is silently skipped
If events exist → Shows formatted list with 12-hour times and titles

Requirements:

gog must be installed and authenticated
Uses the same Google account configured for Gmail (set via GOG_ACCOUNT environment variable)

Email Criteria

Emails are included if they match any of:

Marked as Important by Gmail (lightning bolt icon)
Manually Starred by you
Received in the last 24 hours

AI Summarization

Each email is summarized using the Gemini CLI (gemini):

Extracts the email body (cleans HTML/CSS)
Sends to gemini --model gemini-2.0-flash with a prompt to summarize in 1 sentence
The summary is medium-to-long length natural language (not scraped content)
Falls back to cleaned body text if Gemini is unavailable

Important: The email body is passed as part of the prompt (not via stdin) because the gemini CLI doesn't handle piped input with prompts correctly.

Example output:

🔴 **William Ryan: Invitation to team meeting**
   The email invites you to a team meeting tomorrow at 2pm to discuss the Q1 roadmap and assign tasks for the upcoming sprint.

Read/Unread Indicators

🔴 Red dot = Unread email
🟢 Green dot = Read email

All emails show one of these markers for visual consistency.

Formatting Notes

Subject and Summary Cleanup:

Extra quotes are automatically stripped from subject lines (e.g., ""Agent Skills"" → Agent Skills)
Summaries from Gemini are also cleaned of leading/trailing quotes
This ensures clean, readable output in Telegram/other channels

Cron Schedule

Set up a daily cron job at your preferred time:

cron add --name "Morning Email Rollup" \
  --schedule "0 8 * * *" \
  --tz "America/Denver" \
  --session isolated \
  --message "GOG_ACCOUNT=your-email@gmail.com bash /path/to/skills/morning-email-rollup/rollup.sh"

Adjust the time (8:00 AM) and timezone to your preference.

Customization

Change Number of Emails

By default, the rollup shows 10 emails. To change this:

Temporary (one-time):

MAX_EMAILS=20 bash skills/morning-email-rollup/rollup.sh

Permanent: Edit skills/morning-email-rollup/rollup.sh:

MAX_EMAILS="${MAX_EMAILS:-20}"  # Change 10 to your preferred number

Change Search Criteria

Edit skills/morning-email-rollup/rollup.sh:

# Current: important or starred from last 24h
IMPORTANT_EMAILS=$(gog gmail search 'is:important OR is:starred newer_than:1d' --max 20 ...)

# Examples of other searches:
# Unread important emails only
IMPORTANT_EMAILS=$(gog gmail search 'is:important is:unread newer_than:1d' --max 20 ...)

# Specific senders
IMPORTANT_EMAILS=$(gog gmail search 'from:boss@company.com OR from:client@example.com newer_than:1d' --max 20 ...)

# By label/category
IMPORTANT_EMAILS=$(gog gmail search 'label:work is:important newer_than:1d' --max 20 ...)

Change Time

Update the cron schedule:

# List cron jobs to get the ID
cron list

# Update schedule (example: 7am instead of 8am)
cron update <job-id> --schedule "0 7 * * *" --tz "America/Denver"

Change Summary Style

Edit the prompt in the summarize_email() function in rollup.sh:

# Current: medium-to-long 1 sentence
"Summarize this email in exactly 1 sentence of natural language. Make it medium to long length. Don't use quotes:"

# Shorter summaries
"Summarize in 1 short sentence:"

# More detail
"Summarize in 2-3 sentences with key details:"

Change AI Model

Edit the gemini command in summarize_email():

# Current: gemini-2.0-flash (fast)
gemini --model gemini-2.0-flash "Summarize..."

# Use a different model
gemini --model gemini-pro "Summarize..."

Troubleshooting

Not receiving rollups

# Check if cron job is enabled
cron list

# Check last run status
cron runs <job-id>

# Test manually
bash skills/morning-email-rollup/rollup.sh

Missing emails

Gmail's importance markers may filter out expected emails
Check if emails are actually marked important/starred in Gmail
Try running manual search: gog gmail search 'is:important newer_than:1d'

Summaries not appearing

Check if gemini CLI is installed: which gemini
Test manually: echo "test" | gemini "Summarize this:"
Verify Gemini is authenticated (it should prompt on first run)

Wrong timezone

Cron uses America/Denver (MST/MDT)
Update with: cron update <job-id> --tz "Your/Timezone"

Log History

All rollup runs are logged to:

$HOME/clawd/morning-email-rollup-log.md

Format:

- [2026-01-15 08:00:00] 🔄 Starting morning email rollup
- [2026-01-15 08:00:02] ✅ Rollup complete: 15 emails