← Back to Skills Marketplace
russidan-nadee

Gmail Daily Briefing

by Russidan-Nadee · GitHub ↗ · v1.1.1 · MIT-0
cross-platform ✓ Security Clean
175
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install gmail-daily-briefing
Description
Fetch Gmail emails from the last 24h, rank by importance, summarize into bullet points, and auto-create Google Calendar events for detected meetings.
README (SKILL.md)

\r \r

Email & Calendar Assistant Skill\r

\r

Description\r

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.\r \r

Capabilities\r

  • Read emails (read-only)\r
  • Rank emails by importance\r
  • Summarize emails into bullet points\r
  • Detect meeting/interview emails\r
  • Create Google Calendar events (only when not already added)\r \r

Installation\r

\r Via ClawHub (recommended):\r \r

clawhub install gmail-daily-briefing\r
```\r
\r
Manual:\r
\r
```\r
git clone https://github.com/Russidan-Nadee/gmail-daily-briefing.git ~/.clawdbot/skills/gmail-daily-briefing\r
```\r
\r
## Setup Instructions (First-Time Only)\r
\r
### Step 1 — Get Google API credentials\r
\r
1. Go to [Google Cloud Console](https://console.cloud.google.com/)\r
2. Create a new project (or select existing one)\r
3. In the left sidebar, go to **APIs & Services** → click **Enable APIs and Services**\r
4. Search and enable each of the following:\r
   - **Gmail API**\r
   - **Google Calendar API**\r
5. In the left sidebar, go to **APIs & Services → OAuth consent screen**\r
   - Click **Get Started**\r
   - Fill in **App name** and **User support email** → click **Save and Continue**\r
   - Under **Audience** → click **Add Users** → add your Google email → click **Save**\r
6. In the left sidebar, go to **APIs & Services → Credentials**\r
7. Click **Create Credentials → OAuth client ID**\r
8. Under **Application type** select **Desktop app**\r
9. Give it a name (e.g. `Gmail Daily Briefing`) → click **Create**\r
10. Click **Download JSON** → you'll get a file named `client_secret_*.json`\r
\r
### Step 2 — Connect to the agent\r
\r
1. Send the `client_secret_*.json` file to the agent as an attachment\r
   - Via **Telegram**: send as a file (not photo) in your Clawdbot chat\r
   - Via **Claude Desktop**: drag and drop the file into the chat\r
   - Via **other platforms**: attach the file the same way you attach any document\r
2. The agent will print an authorization URL — click it to open in your browser\r
3. Log in with your Google account and click **Allow**\r
4. Your browser will redirect to a `localhost` page showing an error — **this is normal**\r
5. Copy the **full URL** from your browser address bar (starts with `http://localhost/?...`)\r
6. Paste that URL back to the agent\r
\r
### Step 3 — Done!\r
\r
The agent will confirm: *"Auth complete. I can now access your Gmail and Google Calendar."*\r
\r
From now on just say: **"Summarize today's important emails"**\r
\r
## Agent Instructions\r
\r
> See [`agent/instructions.md`](agent/instructions.md) for full agent instructions (commands, auth setup, behavior).
Usage Guidance
This skill appears to do what it says, but it requires you to provide Google OAuth credentials and will save an OAuth token (token.json) that lets the skill read your Gmail (readonly) and create calendar events. Before installing: (1) Only upload a client_secret JSON you created in your own Google Cloud project and that you trust the agent with; consider creating a separate project/app for least privilege. (2) Understand token.json grants ongoing access — revoke OAuth access in your Google account if you want to stop access. (3) If you prefer not to share credentials with a remote agent, run the setup locally yourself and only upload the resulting token.json if you trust the agent. (4) Review and test with a non-critical account first. The hardcoded timezone in create_event.py (Asia/Bangkok) and a small sorting bug in fetch_emails.py are functional issues (not security) you may want to adjust.
Capability Analysis
Type: OpenClaw Skill Name: gmail-daily-briefing Version: 1.1.1 The skill is a legitimate tool for summarizing Gmail messages and managing Google Calendar events using official Google APIs. The implementation follows standard security practices for OAuth2 (including PKCE in `scripts/setup_auth.py`), uses the least-privilege scope for email access (`gmail.readonly`), and the agent instructions in `agent/instructions.md` are entirely consistent with the stated purpose of the skill. No indicators of data exfiltration, obfuscation, or malicious intent were found.
Capability Assessment
Purpose & Capability
Name/description match the included scripts: fetch_emails.py reads Gmail (Gmail API), create_event.py writes Calendar events (Calendar API). Required binary (python) and Python dependencies in requirements.txt are proportional to the stated functionality.
Instruction Scope
The SKILL.md and agent/instructions.md explicitly instruct the agent to accept a client_secret_*.json upload, write it to the project root, generate an OAuth URL, and instruct the user to paste the redirect URL back. These steps are required for OAuth but involve the agent handling sensitive files (client secret and eventual token.json). The instructions also require the agent to create a local venv and run pip—normal for Python-based skills.
Install Mechanism
No remote downloads or extract steps. The skill is instruction+source included in the package; dependencies are standard google-auth libraries from PyPI (requirements.txt). No unexpected external URLs are used by installers.
Credentials
No environment variables are requested. The skill requires OAuth client credentials (client_secret_*.json) and will create and persist token.json with Gmail readonly and calendar.events scopes—this is appropriate for the described functionality, but these files contain sensitive credentials/tokens and grant the skill access to the user's Gmail and calendar.
Persistence & Privilege
always is false and autonomous invocation is allowed (platform default). The skill stores token.json (and temporary .auth_state.json) in its project directory and auto-refreshes tokens—this is necessary to operate, but means the agent can access Gmail/Calendar when token.json exists. The skill does not request system-wide config changes or other skills' credentials.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gmail-daily-briefing
  3. After installation, invoke the skill by name or use /gmail-daily-briefing
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
- Added a README.md file to the project. - Updated the manual installation path in SKILL.md to use ~/.clawdbot/skills/gmail-daily-briefing for consistency. - No functional changes to the skill itself.
v1.1.0
- Added agent instructions in a new file: agent/instructions.md - SKILL.md updated with installation steps, clearer setup instructions, and metadata section - Improved documentation for user onboarding and agent configuration
v1.0.0
Initial release of Gmail & Google Calendar email assistant. - Reads Gmail emails from the last 24 hours and ranks them by importance. - Summarizes each email into bullet points for easy review. - Detects meeting/interview emails and creates Google Calendar events if not already on the calendar. - Includes setup instructions for Google OAuth authentication with step-by-step guidance. - Provides scripts for fetching emails, creating calendar events, and managing authentication.
Metadata
Slug gmail-daily-briefing
Version 1.1.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Gmail Daily Briefing?

Fetch Gmail emails from the last 24h, rank by importance, summarize into bullet points, and auto-create Google Calendar events for detected meetings. It is an AI Agent Skill for Claude Code / OpenClaw, with 175 downloads so far.

How do I install Gmail Daily Briefing?

Run "/install gmail-daily-briefing" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gmail Daily Briefing free?

Yes, Gmail Daily Briefing is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Gmail Daily Briefing support?

Gmail Daily Briefing is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gmail Daily Briefing?

It is built and maintained by Russidan-Nadee (@russidan-nadee); the current version is v1.1.1.

💬 Comments