Mailo is a lightweight AI-powered email assistant that works entirely over email. No apps. No logins. Just send an email and get smart, context-aware replies delivered straight to your inbox — powered by GPT.
Built for the dev.to Postmark Challenge: Inbox Innovators.
- 📩 Email-first Interface — Just send an email to interact, no account needed.
- 🧠 GPT-Powered Intelligence — Smart, human-like responses tailored to your message.
- ⚡ Fast & Lightweight — No bloated UI, just good old email.
- 🛡️ Privacy-first — Only the message content is used to generate replies.
| Tech | Role |
|---|---|
| Next.js 15 | API routes + landing page |
| Postmark | Inbound email parsing |
| Nodemailer | Sending reply emails |
| OpenAI (via GitHub Models) | LLM backend |
| TypeScript | Type safety |
User → (sends email) to Postmark → Next.js Webhook → GPT-4.1 (GitHub) → Mailo Nodemailer → replies
- Click the Try it out button on the landing page. 📧
- Send an email to the pre-configured address with a clear subject (your question) and detailed body (extra info). 📝
- Wait a few seconds. ⏳
- Check your inbox—you’ll receive a helpful, AI-generated reply to your query! 📬
- You can reply directly to the AI’s response email to continue the conversation. 📣
💡 Feel free to keep the conversation going—just hit "Reply" on any AI-generated response.
git clone https://github.com/shravzzv/mailo.git
cd mailo
npm installCreate a .env file and add:
GITHUB_TOKEN=your_github_models_token
MAIL_USER=your_email@mail.com
MAIL_PASSWORD=your_email_passwordnpm run dev- A user sends an email to a Mailo-linked address.
- Postmark parses it and hits a webhook hosted in your Next.js app.
- The webhook extracts the subject + body, and sends it to GPT.
- GPT generates a concise, email-style reply.
- Nodemailer sends this reply back to the user.
Mailo uses GitHub-hosted OpenAI models, which have a 15 requests/minute and 150 requests/day limit.
If the limit is hit:
- Users receive a graceful fallback response via email.
- Error is logged to the console, but doesn't crash the server.
The assistant is instructed to:
- Respond like a helpful human email assistant.
- Avoid greetings/sign-offs unless explicitly prompted.
- Be polite, concise, and helpful.
- Skip subject line formatting — that’s handled in code.
- Deploy your app on Vercel
- Use Postmark for production-grade email parsing
Pull requests are welcome! For major changes, please open an issue first.
- Fork the repo
- Create a feature branch
- Make changes
- Submit a PR
MIT License. Feel free to fork and modify Mailo for your own AI tools.