email-processor

name	email-processor
description	Automate Gmail inbox processing - categorizes unread emails, marks marketing/newsletters/promotions as read, and surfaces important emails requiring attention. USE WHEN: User asks to "check my emails", "process unread emails", "clean up my inbox", "mark newsletters as read", or any Gmail automation task. REQUIRES: gog CLI (brew install steipete/tap/gogcli) + Google Cloud OAuth credentials

Email Processor

Automates Gmail inbox triage by categorizing unread emails and marking low-priority items as read.

What It Does

1. Fetches all unread emails
2. Identifies marketing, newsletters, promotions, and news
3. Marks low-priority emails as read
4. Surfaces important emails (GitHub, security alerts, direct communications)
5. Generates a summary report

Prerequisites

1. Install gog CLI

brew install steipete/tap/gogcli

Verify installation:

gog --version

2. Google Cloud OAuth Setup

1. Go to Google Cloud Console
2. Create a new project (or use existing)
3. Enable the Gmail API:
   • Navigate to "APIs & Services" > "Library"
   • Search for "Gmail API" and enable it
4. Create OAuth credentials:
   • Go to "APIs & Services" > "Credentials"
   • Click "Create Credentials" > "OAuth client ID"
   • Select "Desktop app" as application type
   • Download the JSON file

3. Authenticate gog

# Set credentials
gog auth credentials /path/to/client_secret.json

# Add your Gmail account
gog auth add [e-mail] --services gmail


gog auth list