Daily Email Summary
Scanned@bbdyno
npx machina-cli add skill @bbdyno/email-summary --openclawEmail Summary Skill
This skill fetches recent emails from your Gmail account and provides AI-powered summaries.
How it works
When invoked, this skill will:
- Authenticate with Gmail API using credentials at
$GMAIL_CREDENTIALS_PATH - Fetch recent emails (default: last 10 unread emails)
- Summarize each email with:
- Sender and subject
- Key points from the email body
- Recommended actions or responses
- Present results in an organized, easy-to-scan format
Instructions for the Agent
When this skill is invoked:
- First, verify that the Gmail API credentials exist at the path specified in
$GMAIL_CREDENTIALS_PATHenvironment variable - Run the helper script located at
{baseDir}/scripts/fetch_emails.pywith the appropriate arguments:- Default:
python3 {baseDir}/scripts/fetch_emails.py --count 10 - With arguments:
python3 {baseDir}/scripts/fetch_emails.py $ARGUMENTS
- Default:
- Parse the JSON output from the script
- For each email, provide a concise summary including:
- From: Sender name and email
- Subject: Email subject line
- Summary: 2-3 sentence summary of key points
- Action: Suggested action (reply, archive, flag for follow-up, etc.)
- Present all summaries in a well-formatted list
Usage Examples
/email-summary
Fetches and summarizes the last 10 unread emails.
/email-summary --count 20
Fetches and summarizes the last 20 unread emails.
/email-summary --all
Fetches and summarizes all unread emails.
Setup Requirements
Before using this skill, ensure:
- Gmail API credentials are configured
- Environment variable
GMAIL_CREDENTIALS_PATHpoints to your credentials JSON file - Python 3 and required packages are installed (see setup guide in README.md)
Overview
This skill connects to your Gmail account via the Gmail API and fetches your recent emails. It summarizes each message with the sender, subject, key points from the body, and a recommended action. The output is organized as a concise inbox digest.
How This Skill Works
When invoked, it authenticates using credentials at GMAIL_CREDENTIALS_PATH, retrieves recent messages (default last 10 unread), and generates a concise summary for each including From, Subject, Summary, and Action. The results are presented in a well-formatted list.
When to Use It
- You want a quick check of new messages without reading every email.
- You need a prioritized digest of the last unread emails.
- You’re preparing a daily briefing for yourself or your team.
- You want to identify actionable items (reply, archive, flag for follow-up, etc.) from emails.
- You’re triaging a busy inbox and want a summary before responding.
Quick Start
- Step 1: Ensure Gmail API credentials exist at the path specified by GMAIL_CREDENTIALS_PATH.
- Step 2: Run the helper script with the default or your desired count: python3 {baseDir}/scripts/fetch_emails.py --count 10
- Step 3: Read the JSON output and review each email summary (From, Subject, Summary, Action).
Best Practices
- Keep the GMAIL_CREDENTIALS_PATH secure and rotate credentials regularly.
- Start with a small count (e.g., 10) to avoid information overload before increasing.
- Review each summary for sensitive content before acting on it.
- If needed, adjust to include read emails by changing parameters or script logic.
- Test the workflow with a non-critical inbox or sandbox account.
Example Use Cases
- Daily inbox digest in the morning for a manager.
- Project inbox summaries to support sprint planning.
- Support ticket inbox triage with suggested actions (reply, escalate, close).
- Executive digest highlighting high-priority messages and deadlines.
- Personal inbox skim before meetings to surface important topics.
