← Back to Skills Marketplace
1960
Downloads
1
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install email-summary
Description
Fetches recent emails from Gmail and provides concise summaries. Use when the user wants to check emails, get email summaries, or review their inbox.
README (SKILL.md)
Email 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)
Usage Guidance
This skill appears to do what it says: it reads Gmail (readonly), creates a local OAuth token file (token.json), and outputs message JSON for the agent to summarize. Before installing: ensure the GMAIL_CREDENTIALS_PATH points to a credentials JSON you created in your Google Cloud Console; be aware that the email text returned by the script will be sent to the agent/AI for summarization (privacy risk if emails contain sensitive data); verify the skill's repository/source if provenance matters (the listed homepage looks like a placeholder); install Python packages in a virtual environment; after use you can revoke the OAuth token/credentials in your Google account if needed. If you want absolute assurance, inspect scripts/fetch_emails.py locally (it is short and readable) and confirm it meets your policies before granting access.
Capability Analysis
Type: OpenClaw Skill
Name: email-summary
Version: 1.0.0
The skill is designed to fetch and summarize emails from Gmail, and its implementation aligns with this stated purpose. The `scripts/fetch_emails.py` script explicitly requests `https://www.googleapis.com/auth/gmail.readonly` scope, limiting its access to read-only operations. There is no evidence of data exfiltration beyond the intended email content, no malicious execution of arbitrary commands, and no attempts at prompt injection against the agent to perform actions outside the skill's scope. All file and network access is confined to legitimate Gmail API interactions and local credential/token storage.
Capability Assessment
Purpose & Capability
Name/description, required binary (python3), required env var (GMAIL_CREDENTIALS_PATH), included Python script, and listed Python dependencies all align with a Gmail-reading-and-summarization skill. The declared Gmail readonly scope (https://www.googleapis.com/auth/gmail.readonly) matches the stated purpose. Note: registry 'Source' is marked unknown and the homepage is a placeholder (github.com/yourusername/...), so provenance is not fully verified.
Instruction Scope
SKILL.md instructs the agent to verify GMAIL_CREDENTIALS_PATH, run scripts/fetch_emails.py, parse its JSON output, and summarize each email. The helper script only accesses the credentials path, performs OAuth, fetches unread messages, decodes bodies (truncated to 1000 chars), and returns JSON — consistent with the stated purpose. Important privacy note: email contents produced by the script are intended to be summarized by the agent/AI, which means your email text will be sent to OpenClaw's model/service for processing; SKILL.md and README mention this explicitly. The script does not reference or exfiltrate data to other endpoints.
Install Mechanism
This is instruction-only with bundled Python code and a requirements.txt listing standard google-auth/google-api packages. There is no remote download/install step, no URL shorteners, and no archive extraction. Installing the dependencies via pip is the only install action required — proportional to the task.
Credentials
Only GMAIL_CREDENTIALS_PATH is required. The script uses that env var and stores OAuth tokens as token.json next to the credentials file. The requested environment access (a path to OAuth client credentials) is appropriate and minimal for Gmail API access. The skill requests only the Gmail readonly scope, which is proportionate. No unrelated secrets or system-wide config paths are requested.
Persistence & Privilege
always is false and the skill does not request elevated or persistent platform privileges. The script writes token.json into the same directory as the credentials (expected behavior for OAuth flows). The skill does not modify other skills or global agent settings. The agent's ability to call the skill autonomously (disable-model-invocation=false) is the platform default and not sufficient alone to raise concern.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install email-summary - After installation, invoke the skill by name or use
/email-summary - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Email Summary skill.
- Fetches recent emails from Gmail and provides concise, AI-powered summaries.
- Summaries include sender, subject, key points, and recommended actions.
- Supports custom email count and all unread emails via command-line arguments.
- Requires Gmail API credentials and the `GMAIL_CREDENTIALS_PATH` environment variable.
- Compatible with macOS, Linux, and Windows.
Metadata
Frequently Asked Questions
What is Daily Email Summary?
Fetches recent emails from Gmail and provides concise summaries. Use when the user wants to check emails, get email summaries, or review their inbox. It is an AI Agent Skill for Claude Code / OpenClaw, with 1960 downloads so far.
How do I install Daily Email Summary?
Run "/install email-summary" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Daily Email Summary free?
Yes, Daily Email Summary is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Daily Email Summary support?
Daily Email Summary is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux, win32).
Who created Daily Email Summary?
It is built and maintained by bbdyno (@bbdyno); the current version is v1.0.0.
More Skills