MailSpark

A lightweight local tool for sending bulk emails from your machine. Write EJS templates, manage contacts with custom variables, preview before sending, and track delivery — no cloud service required.

Run

No installation needed. Use your package manager's executor directly:

npx mailspark
# or
bunx mailspark
# or
pnpm dlx mailspark

Opens at http://localhost:2525.

How It Works

SMTP

Enter your outgoing mail server credentials and click Test Connection to verify.

Contacts

Add email addresses with a Meta JSON object — its keys become variables in your templates:

{ "name": "Alice", "company": "Acme", "role": "Engineer" }

Templates

Write email bodies in EJS using contact meta as variables:

<h1>Hi <%= name %>,</h1>
<p>Welcome to <%= company %>!</p>

Click Preview to render the template for any contact before sending.

Send

Pick a template, write a subject, select contacts. Each contact shows a compatibility badge — green means all template variables are present in their meta. Hit Send.

Logs

Every send is recorded with recipient, subject, template, and delivery status.

Data

Everything is stored locally as plain JSON — no database, no cloud.

data/       contacts, templates, logs, SMTP config
templates/  *.ejs template files

For issues or support: [email protected] · MIT