📧 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