# 📧 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

```text
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

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

### Go into the project

```bash
cd MailPilot-AI
```

### Create a virtual environment

```bash
python -m venv .venv
```

### Activate the virtual environment

Windows

```bash
.venv\Scripts\activate
```

Linux / macOS

```bash
source .venv/bin/activate
```

### Install dependencies

```bash
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

```bash
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