🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Gmail Checker
πŸ¦€ ClawHub

Gmail Checker

by @99rebels

Check Gmail for unread inbox emails, filtered by priority. Use when asked to check emails, check inbox, email digest, email summary, or "any new mail". Outpu...

Versionv1.3.2
Downloads705
#crypto-defi#legal#communication
TERMINAL
clawhub install rebels-gmail-checker

πŸ“– About This Skill

name: gmail-checker description: > Check Gmail for unread inbox emails, filtered by priority. Use when asked to check emails, check inbox, email digest, email summary, or "any new mail". Outputs a brief list sorted by priority (HIGH/MEDIUM/LOW). Skips marketing, promotions, social, and update categories. Configurable via gmail-config.json.

Gmail Checker πŸ“§

Fetch unread Gmail messages, filter out noise, deliver a prioritized digest.

Why

Your inbox is full of automated emails, promotions, and updates. This skill surfaces what actually matters β€” security alerts, personal messages, and anything you've flagged as important.

When to Use

  • "Check my emails"
  • "Any new mail?"
  • "Give me an email digest"
  • "What's in my inbox?"
  • "Email summary"

    • Setup

    First-time users need Google OAuth credentials. If the script exits with a "missing file" error, read references/setup.md and walk the user through the setup flow.

    pip install google-api-python-client google-auth-oauthlib

    How to Run

    python3 scripts/check_gmail.py [hours]          # default: last 24h
python3 scripts/check_gmail.py --json [hours]   # structured JSON output

    Config: Copy config.example.json to /gmail-config.json and customize. The script prints the resolved path if credentials are missing.

    Data Directory

    Credentials and config resolve to:

    1. $SKILL_DATA_DIR (set by agent platform)
2. ~/.config/gmail-checker/  (default fallback)

    Any platform can set $SKILL_DATA_DIR to their preferred credential store. If unset, ~/.config/gmail-checker/ is used automatically. Works with OpenClaw, Claude Code, Codex, and any agent that can run Python scripts.

    Priority Rules

    πŸ”΄ HIGH   β†’ Sender domain or subject matches your config
🟑 MEDIUM β†’ Gmail-labeled personal messages
🟒 LOW    β†’ Everything else (still inbox, still unread)


    Filtered out entirely:
β€’ CATEGORY_PROMOTIONS
β€’ CATEGORY_UPDATES
β€’ CATEGORY_FORUMS
β€’ CATEGORY_SOCIAL

    Customize priorities in gmail-config.json:

    high_priority_domains:   ["stripe.com", "github.com"]
high_priority_keywords:  ["security", "urgent", "billing"]

    Output Example

    Unread Inbox (last 24h)
    πŸ”΄ HIGH
  Security alert: new sign-in from unknown device
  from: Google 
    🟑 MED
  Re: dinner friday?
  from: Sarah 
    🟒 LOW
  Your weekly GitHub digest
  from: GitHub 
    3 unread emails

    Adapt formatting for the current channel (bold, bullets, etc.).

    Suggested Integration

    cron: 0 8 * * * β†’ python3 scripts/check_gmail.py

    ⚑ When to Use

    TriggerAction
    - "Any new mail?"
    - "Give me an email digest"
    - "What's in my inbox?"
    - "Email summary"

    βš™οΈ Configuration

    First-time users need Google OAuth credentials. If the script exits with a "missing file" error, read references/setup.md and walk the user through the setup flow.

    pip install google-api-python-client google-auth-oauthlib