Mail Summary
by @russidan-nadee
Fetch Gmail emails from the last 24h, rank by importance, summarize into bullet points, and auto-create Google Calendar events for detected meetings.
clawhub install mail-summaryπ About This Skill
name: mail-summary description: Fetch Gmail emails from the last 24h, rank by importance, summarize into bullet points, and auto-create Google Calendar events for detected meetings.
Email & Calendar Assistant Skill
Description
This skill reads Gmail emails, ranks them by importance, summarizes each email into bullet points, and creates Google Calendar events if an email contains a meeting or interview that is not already on the calendar.Capabilities
Installation
Via ClawHub (recommended):
clawhub install mail-summary
Manual:
git clone https://github.com/Russidan-Nadee/mail-summary.git ~/.openclaw/workspace/skills/mail-summary
Setup Instructions (First-Time Only)
Step 1 β Get Google API credentials
1. Go to Google Cloud Console
2. Create a new project (or select existing one)
3. In the left sidebar, go to APIs & Services β click Enable APIs and Services
4. Search and enable each of the following:
- Gmail API
- Google Calendar API
5. In the left sidebar, go to APIs & Services β OAuth consent screen
- Click Get Started
- Fill in App name and User support email β click Save and Continue
- Under Audience β click Add Users β add your Google email β click Save
6. In the left sidebar, go to APIs & Services β Credentials
7. Click Create Credentials β OAuth client ID
8. Under Application type select Desktop app
9. Give it a name (e.g. Mail Summary) β click Create
10. Click Download JSON β you'll get a file named client_secret_*.json
Step 2 β Connect to the agent
1. Send the client_secret_*.json file to the agent as an attachment
- Via Telegram: send as a file (not photo) in your Clawdbot chat
- Via Claude Desktop: drag and drop the file into the chat
- Via other platforms: attach the file the same way you attach any document
2. The agent will print an authorization URL β click it to open in your browser
3. Log in with your Google account and click Allow
4. Your browser will redirect to a localhost page showing an error β this is normal
5. Copy the full URL from your browser address bar (starts with http://localhost/?...)
6. Paste that URL back to the agent
Step 3 β Done!
The agent will confirm: *"Auth complete. I can now access your Gmail and Google Calendar."*
From now on just say: "Summarize today's important emails"
Configuration
This skill uses a config.yaml file in the project root for runtime configuration. You can edit this file to control timezone, retry behavior, and logging level.
Example config.yaml:
timezone: Asia/Bangkok # Timezone for calendar events (e.g. Asia/Bangkok, UTC, Asia/Tokyo)
max_retries: 5 # Max retry attempts for authentication and API calls
log_level: INFO # Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL
Agent Instructions
> See agent/instructions.md for full agent instructions (commands, auth setup, behavior).
βοΈ Configuration
This skill uses a config.yaml file in the project root for runtime configuration. You can edit this file to control timezone, retry behavior, and logging level.
Example config.yaml:
timezone: Asia/Bangkok # Timezone for calendar events (e.g. Asia/Bangkok, UTC, Asia/Tokyo)
max_retries: 5 # Max retry attempts for authentication and API calls
log_level: INFO # Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL