📧 MailPilot-AI

AI-powered Gmail Assistant built using FastMCP and the Gmail API.

MailPilot-AI is an intelligent Gmail assistant that connects with Gmail using OAuth2 authentication and provides AI-powered email management features such as reading, searching, sending, replying, summarizing, and organizing emails.

---

✨ Features

• 📥 Read latest emails
• 📬 Read unread emails
• 🔍 Search emails
• 📖 Open complete email
• 📤 Send emails
• 💬 Reply to emails
• ⭐ Star emails
• 📦 Archive emails
• 🗑 Delete emails
• ✔ Mark emails as read
• 🤖 AI Inbox Summary
• 🧠 Smart email workflows
• 🔐 Secure Gmail OAuth authentication

---

🏗 Project Structure

MailPilot-AI/
│
├── agent/
│   ├── email_service.py
│   ├── inbox_summary.py
│   ├── memory.py
│   ├── planner.py
│   ├── reply_generator.py
│   └── workflows.py
│
├── gmail/
│   ├── actions.py
│   ├── attachments.py
│   ├── compose.py
│   ├── reader.py
│   └── search.py
│
├── docs/
├── tests/
│
├── auth.py
├── gmail_api.py
├── server.py
├── requirements.txt
└── README.md

---

🛠 Tech Stack

• Python
• FastMCP
• Gmail API
• OAuth 2.0
• Google Cloud Platform
• Git
• GitHub

---

🚀 Getting Started

Clone the repository

git clone https://github.com/himateja1/MailPilot-AI.git

Go into the project

cd MailPilot-AI

Create a virtual environment

python -m venv .venv

Activate the virtual environment

Windows

.venv\Scripts\activate

Linux / macOS

source .venv/bin/activate

Install dependencies

pip install -r requirements.txt

Configure Gmail API

1. Create a Google Cloud Project.
2. Enable the Gmail API.
3. Download credentials.json.
4. Place credentials.json in the project root.
5. Run authentication once.

---

▶ Running the Project

python server.py

---

📸 Screenshots

Inbox Summary

Add screenshot here

---

Reading Emails

Add screenshot here

---

Sending Emails

Add screenshot here

---

MCP Server

Add screenshot here

---

📌 Future Improvements

• 🎤 Voice commands
• 📅 Google Calendar integration
• 📎 Attachment summarization
• 🌐 Web dashboard
• 🤖 Multi-agent support
• 🧠 RAG over emails
• 📱 Mobile companion

---

🤝 Contributing

Contributions, ideas, and suggestions are welcome.

Feel free to fork the repository and submit a pull request.

---

📄 License

This project is for educational and portfolio purposes.

---

👨‍💻 Author

Himateja

GitHub: https://github.com/himateja1