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)

Installation

Via ClawHub (recommended):

clawhub install gmail-daily-briefing

Manual:

git clone https://github.com/Russidan-Nadee/gmail-daily-briefing.git ~/.clawdbot/skills/gmail-daily-briefing

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. Gmail Daily Briefing) → 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"

Agent Instructions

See agent/instructions.md for full agent instructions (commands, auth setup, behavior).