Skip to main content
Glama
himateja1

MailPilot-AI

by himateja1
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

📧 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

Related MCP server: Gmail AutoAuth MCP Server

🏗 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Gmail AutoAuth MCP Server

    raghavared
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage Gmail through natural language, supporting operations like sending, searching, and reading emails. It includes comprehensive label management, batch processing, and a streamlined OAuth2 auto-authentication flow.
    MIT

  • Gmail AutoAuth MCP Server

    StephenLReed
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage Gmail through natural language interactions, including sending, reading, searching emails, and managing labels with auto authentication support.
    14,810 npm
    1
    MIT

  • Gmail AutoAuth MCP Server

    lowrykun
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage Gmail through natural language, including sending, reading, searching, labeling emails, managing attachments, and performing thread operations.
    3
    MIT