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

• Read emails (read-only)
• Rank emails by importance
• Summarize emails into bullet points
• Detect meeting/interview emails
• Create Google Calendar events (only when not already added)
• Auto-refreshes Google OAuth token as needed for uninterrupted access.

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).