Profile
Back to NewsBack
GitHub Trending 5 min
Reader Mode
Lakshay1509/NeatMail: Get to inbox zero faster

Lakshay1509/NeatMail: Get to inbox zero faster

21 hours ago

NeatMail

Never drop a promise buried in your inbox

NeatMail is an AI email assistant for Gmail and Outlook that tracks every promise you make and every promise made to you, files them under one Follow up label, and drafts the follow-up when it's due — plus auto-labeling, replies in your own voice, and a clearer inbox.

Website • Pricing • Blog • Use Cases • Free Tools • Features • Getting Started

License TypeScript Next.js React

NeatMail Hero

Table of Contents

- Prerequisites - Installation

What is NeatMail?

NeatMail is an email management platform that automatically organizes your Gmail and Outlook inboxes in real-time. No complicated setup, no manual sorting — just clean, organized emails labeled exactly where you need them.

Want to see how it stacks up? Read Superhuman vs NeatMail: email productivity compared (2026), check out our pricing plans, or learn more about the team.


Features

  • Gmail & Outlook Integration: Connect in minutes via OAuth. Labels sync directly in real time.
  • Smart Email Labeling: AI automatically categorizes incoming emails into labels like Action Needed or Pending Response.
  • Custom Labels: Create personalized label systems to match your exact workflow.
  • AI-Powered Draft Replies: Auto-generate context-aware draft responses based on your conversation history and writing tone. See how AI draft generation actually works.
  • One-Click Unsubscribe: Instantly remove unwanted newsletters to keep your inbox clutter-free.
  • Auto-Archive Rules: Set rules to automatically archive emails based on labels, senders, or categories.
  • Follow-Ups: Never drop a thread — NeatMail surfaces emails that need a nudge. Learn how to handle email follow-ups.
  • Telegram Integration: Receive alerts, set routing rules, and approve AI drafts directly from Telegram.
See the full feature list and pricing →

Product Screenshots

Dashboard
Dashboard
Smart Labels
Smart Labels
AI Drafts
AI Drafts
One-Click Unsubscribe
One-Click Unsubscribe
One-Click Cleanup
One-Click Cleanup
Follow-Ups
Follow-Ups

Product Video

NeatMail Product Video


Built for Your Team & Industry

NeatMail adapts to how different teams and industries handle email. Explore the workflow built for you:

By role

By industry

Guides & Resources

Practical guides from the NeatMail blog on inbox zero, email organization, and productivity:

See all posts on the blog → · Track updates in the changelog.

Free Email Tools

Free, no-signup email tools from NeatMail:


Getting Started

Prerequisites

  • Bun (this project's package manager) and Node.js 20+
  • PostgreSQL database
  • Redis instance (e.g., Upstash)
  • Third-party credentials for:
- Clerk (Authentication) - OpenAI or Azure OpenAI (AI classification & drafts) - Google Cloud Console (Gmail API & Pub/Sub Webhooks) - Microsoft Entra (Outlook API & Webhooks) - BullMQ (Background jobs and queues — with Bull Board UI at /api/bullboard) - DodoPay (Payments) - Resend (Transactional emails) - Telegram (Bot token for chat integrations)

Installation

  1. Clone the repository
git clone https://github.com/Lakshay1509/NeatMail.git
   cd neatmail
  1. Install dependencies
bun install
  1. Set up environment variables
cp .env.example .env.local
  1. Set up the database
bunx prisma db push
   bunx prisma generate
  1. Run the development server
bun run dev
Open http://localhost:3000 in your browser.

Architecture

graph TD
    subgraph Email Providers
        Inbox[Gmail / Outlook]
        PubSub[Google Pub/Sub / MS Graph]
    end

Inbox -->|Push Notification| PubSub PubSub -->|Webhook| API[NeatMail API]

subgraph Core Processing API -->|Enqueue Job| BullMQ[BullMQ Worker] BullMQ -->|Fetch Full Email| Inbox BullMQ -->|Analyze Email| AI[OpenAI / Azure] AI -->|Labels & Drafts| BullMQ BullMQ -->|Apply Labels & Drafts| Inbox end

subgraph Data & State BullMQ -->|Store Metadata| DB[(PostgreSQL)] BullMQ -->|Cache & Deduplication| Redis[(Redis)] end

subgraph Notifications BullMQ -->|Send Alerts| Telegram[Telegram Bot] end


Tech Stack

  • Frontend: Next.js 16.1.1, React 19, Tailwind CSS 4, shadcn/ui, TanStack Query
  • Backend: Hono.js, Prisma, PostgreSQL, Redis (Upstash), Clerk, BullMQ
  • AI: OpenAI GPT-4 Mini
  • Integrations: Google APIs, Microsoft Graph API, DodoPay, Svix

Configuration

Refer to the code comments and documentation for detailed setup instructions for the Gmail API, Outlook API, and Clerk. Webhooks are central to how NeatMail works — make sure your Google Cloud Pub/Sub and Clerk webhook endpoints are correctly configured before testing.


Deployment

NeatMail is optimized for Vercel.

Deploy with Vercel</a>

  1. Deploy to Vercel and configure environment variables.
  2. Run database migrations: npx prisma migrate deploy
  3. Point your webhooks (Pub/Sub, Clerk, DodoPay) to the new domain.

Contributing

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/your-feature)
  3. Commit your changes (git commit -m 'Add your feature')
  4. Push to the branch (git push origin feature/your-feature)
  5. Open a pull request

License

Distributed under the Elastic License 2.0. See LICENSE for more information.


Chat with me