Gmail AI Agent

LLM-powered email assistant that reads, classifies, and auto-drafts Gmail responses using AI reasoning.

Overview

High-volume email workflows drain productivity. This AI agent connects to Gmail via the Gmail API, reads incoming messages, classifies them by intent and priority, and uses a large language model to generate contextually appropriate draft replies — reducing time spent on routine correspondence by automating the read-classify-draft loop.

Tech Stack

Component	Technology
Email Access	Gmail API (OAuth 2.0)
AI Reasoning	LLM (GPT / Gemini via API)
Classification	LLM zero-shot intent classification
Automation Layer	Python orchestration loop
Auth	Google OAuth 2.0 credentials

How It Works

• Authenticate with Gmail API using OAuth 2.0 flow
• Fetch unread or recent messages from specified labels/inbox
• Classify each email by intent (e.g., meeting request, support, inquiry)
• Generate draft reply using LLM prompt with email context injected
• Save draft back to Gmail Drafts folder for human review before sending

Quick Start

git clone https://github.com/shahidbaig-shaik/gmail-ai-agent-
cd gmail-ai-agent-
pip install -r requirements.txt
# Add credentials.json from Google Cloud Console
python agent.py