Painless personal email sending to LOTS of people
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Sending personal emails to LOTS of people should not be a pain in the ass. Helot lets you send an email to a CSV list of recipients, based on a Markdown template.

This project was developed entirely in my browser using SourceLair.


To install Helot just run npm install -g helot.


Command Line Interface

To send an email to a CSV list of recipients with Helot, run the following command in your terminal:

helot --template=/path/to/ --recipients=/path/to/recipients.csv

Command Line Options

The Command Line Interface of Helot can be configured using the following options:


The path to the front-matter enabled Markdown template that Helot should parse and render with each recipient's data.

Template example
subject: Party next week

Hello {{ name }},

Next week we are throwing a party at **Awesome Place**. What about leaving {{ address }} and coming over?

It would be awesome to meet there and have fun.

Looking forward to seeing you.


The path to the recipients file that will be used to send the emails and render each template.

Example recipients file
John Doe,,1 Sesame str.
Bob,,1024 Public Rd.
Alice,,2048 Private Rd.
out (optional)

Path to a file to which output should be written instead of stderr.

dry-run (optional)

Don't send any email. Just print the output.

env-file (optional)

Path to a file that contains environment variables to load. Default value: .env

Example env file
SMTP_PASSWORD=your email password
HELOT_FROM=Your name <>

Environment Configuration

Helot should be configured to send emails through an SMTP server. Configuration should happen using the environment variables documented below.


This is the address of the SMTP server that will send the emails. Example value:


This is the port used to access the SMTP server that will send the emails. Example value: 465.


This is the login (username) used to authenticate with the SMTP server that will send the emails. Example value:


This is the password used to authenticate with the SMTP server that will send the emails, along with the given SMTP login/username. Example value: your email password.


This is the address from which the emails will be sent. Example value: Paris Kasidiaris <>.

Default value: If this environment variable is not configured it will fall back to the value of SMTP_LOGIN.


Helot is licensed under the MIT License. Detailed license info can be found at the LICENSE file.