I Replaced My Gmail Automation with a Free GitHub + AI Workflow ๐
Over the last few days, I built an AI-powered Gmail assistant that runs entirely on GitHub Actions. The goal was simple: ๐ง Let AI organize my inbox automatically, generate replies when needed, and keep everything structured without me constantly checking emails. What it does: โ
Reads new unread emails โ
Uses AI to understand the sender, subject, and email content โ
Automatically applies labels โ
Creates draft replies for emails that need a response โ
Runs 24/7 in the cloud โ
No VPS โ
No server โ
No Docker โ
No monthly automation subscription The labels it uses: ๐ To Respond โ Emails that genuinely need my reply ๐ค Collaboration โ Partnerships, sponsorships, interviews, guest posts, affiliate opportunities, etc. ๐
Meeting โ Scheduling, calls, consultations, and calendar-related emails ๐ข Marketing โ Newsletters, product updates, launches, and promotional content โ๏ธ Cold Email โ Sales pitches, SEO offers, agency outreach, and unsolicited business emails ๐ Notification โ Security alerts, verification codes, account activity, receipts, and automated system emails โ ๏ธ Review Manually โ Unclear emails, contracts, legal matters, invoices, or anything AI isn't confident about ๐ค AI Processed โ Marks emails already handled by the workflow โ๏ธ AI Draft Created โ Marks emails where the AI generated a draft reply The stack is surprisingly simple: โข Python โข Gmail API โข Gemini API โข GitHub Actions That's it. I actually expected this project to be much harder. Most of the work wasn't codingโit was figuring out Gmail OAuth, refining prompts, testing edge cases, and teaching the AI exactly how I wanted my inbox organized. Once that was done, the workflow became very straightforward and surprisingly reliable. The best part? It runs completely on GitHub Actions using GitHub's free minutes, so there are essentially no ongoing hosting costs for most personal use cases. If you'd like to build this for yourself, send me a DM on X (@msaad_alam) or if you dont have X send me a DM here on Skool or an email at contact@dnnengineer.com.