Email Agent

AI-powered email management system with automated replies and email generation.

Features

• Inbox browsing: Lists threads and loads message content on demand
• AI drafting: Generate and preview emails/replies using OpenAI
• Reply sending: Sends replies via EmailEngine with correct message reference
• Auto-reply: Optional global toggle to auto-generate and send replies on new message webhooks
• Webhook handling: Receives EmailEngine webhooks and triggers the auto-reply flow

Requirements

• Node 18+
• EmailEngine instance and an account connected (IMAP/SMTP handled by EmailEngine)
• OpenAI API key

Environment Variables

Create .env.local in the project root with the following keys:

# OpenAI
OPENAI_API_KEY=sk-...

# EmailEngine
EMAIL_ENGINE_BASE_URL=https://your-emailengine-host
EMAIL_ENGINE_API_KEY=ee_access_token
EMAIL_ENGINE_ACCOUNT=[email protected]


Notes:
- `EMAIL_ENGINE_ACCOUNT` must match the EmailEngine account identifier (usually your email address) used for sending/receiving.

## Installation

```bash
npm install

Development

npm run dev

The dev server runs on port 3000 (or next available). Open http://localhost:3000.

Webhook Configuration (EmailEngine)

Point EmailEngine webhooks to:

• POST /api/webhook/emailengine

On messageNew events, the server can auto-generate and send a reply when the global auto-reply toggle is enabled and the message is addressed to EMAIL_ENGINE_ACCOUNT.

API Endpoints

• GET /api/account — Returns configured account info.
• GET /api/emails — Lists inbox threads (via EmailEngine).
• GET /api/emails/thread/[threadId] — Lists messages in a thread.
• GET /api/emails/content/[messageId] — Loads message content (html/text) by text id.
• POST /api/send — Generates or sends email; supports action: "preview" | "send" and reference for replies.
• POST /api/auto-reply — Generates a reply for a thread (manual flow used by UI).
• GET/POST /api/auto-reply/toggle — Read/update global auto-reply flag.
• POST /api/webhook/emailengine — EmailEngine webhooks.