https://github.com/customeros/mailsherpa
CLI to verify an if an email address is deliverable. Uses SMTP to validate email addresses without sending an email.
https://github.com/customeros/mailsherpa
email email-validation email-verfication email-verification email-verifier emails emails-checker go golang smtp smtp-checker
Last synced: about 20 hours ago
JSON representation
CLI to verify an if an email address is deliverable. Uses SMTP to validate email addresses without sending an email.
- Host: GitHub
- URL: https://github.com/customeros/mailsherpa
- Owner: customeros
- License: agpl-3.0
- Created: 2024-08-02T19:18:00.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-03-10T09:16:13.000Z (about 1 month ago)
- Last Synced: 2025-04-03T09:11:12.267Z (11 days ago)
- Topics: email, email-validation, email-verfication, email-verification, email-verifier, emails, emails-checker, go, golang, smtp, smtp-checker
- Language: Go
- Homepage: https://docs.customeros.ai
- Size: 569 KB
- Stars: 20
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-opensource-email - CustomerOS MailSherpa - A CLI for verifying email address deliverability over SMTP without sending an email. - `AGPL-3.0`, `Go` (Deliverability / Email Verification)
README
MailSherpa
A CLI for verifying email address deliverability over SMTP without sending an email.
## 👉 [Live Demo: https://customeros.ai](https://customeros.ai/is/email-verification)
This is open-source, but we also offer a hosted API that's simple to use. If you are interested, find out more at [CustomerOS](https://docs.customeros.ai/api-reference/verify/verify-an-email-address). If you have any questions, you can contact me at [email protected].
## Installation
If you want to use our install script, you can run the following command:
```
curl -sSL https://mailsherpa.sh/install.py | python3
```
otherwise, follow the diretions below:
Download the appropriate CLI tarball for your OS:
```
wget mailsherpa.sh/mailsherpa-linux-arm64.tar.gz
wget mailsherpa.sh/mailsherpa-linux-amd64.tar.gz
wget mailsherpa.sh/mailsherpa-macos.tar.gz
```
Extract the binary:
```
tar -xzf filename.tar.gz
```
4. Test to make sure everything is working
```
./mailsherpa version
```
## Set env variables
Set the `MAIL_SERVER_DOMAIN` environment variable. See the `Mail Server setup guide` section below for more details:
```
export MAIL_SERVER_DOMAIN=example.com
```
## Mail Server setup guide
You might be asking why you need to setup a mail server. For basic testing, you don't. Just set the mailserver domain to whatever you want and run locally.
However, what you'll quickly find is some email servers check to see if the verification request is coming from a legit mail server, and if not, they block it.
To get around this, you need a server with access to port 25 (we like Hetzner or OVH), configured to look like a mail server.
If you would like help setting this up, ping me at [email protected]