Maddy

Composable all-in-one Go mail server — SMTP + IMAP.

Visit Maddy Start free with MailKite

How MailKite fits

Maddy is self-host SMTP+IMAP. MailKite is managed — no server to run.

Receive email into Maddy via MailKite

A minimal, copy-paste starter. Swap in your own domain and API key.

webhook.ts

import { verifyWebhook } from "@mailkite/client";

// MailKite POSTs every inbound email at your domain as JSON.
// Point a route at this handler in the MailKite dashboard.
export default async function handler(req: Request) {
  const raw = await req.text();
  const sig = req.headers.get("x-mailkite-signature") ?? "";

  // Reject anything not signed by your webhook secret
  const ok = await verifyWebhook(sig, raw, process.env.MK_WEBHOOK_SECRET!);
  if (!ok) return new Response("bad signature", { status: 401 });

  const email = JSON.parse(raw);
  // Route into Maddy: open a ticket, create a task, store a record
  await routeIntoName(email);   // email.from · email.subject · email.text

  return new Response(JSON.stringify({ ok: true }));
}

Read the inbound webhooks guide

Maddy is a composable all-in-one mail server written in Go (Apache-2.0) combining SMTP and IMAP in a single binary. It's modular (maddy-compose), with TLS automation, DKIM, and sqlite/PostgreSQL backends — good for small self-hosted deployments.