FGRibreau/mailchecker

📫 Cross-language temporary (disposable/throwaway) email detection library. Covers 55 734+ fake email providers.

PHP

1,912

2,233 commits

updated Oct 5, 2026

twitter.com/FGRibreau

See the code

README

MailChecker

PyPI - Downloads

Crates.io

npm

Gem

Packagist

Cross-language email validation. Backed by a database of over 55 000 throwable email domains.

Validate the format of your email (uses validator.js email regex underneath and FILTER_VALIDATE_EMAIL for PHP)
Validate if the email is not a temporary mail (yopmail-like..., add your own dataset to list.txt)

This will be very helpful when you have to contact your users and you want to avoid errors causing lack of communication or want to block "spamboxes".

Sponsors

France-Nuage _{Sovereign French cloud for your signup pipeline. No vendor lock-in.}	Hook0 _{Send signup events as signed webhooks. Self-hosted, retry built-in.}	Natalia _{Catch the leads that signed up with bad emails — Natalia calls them back.}	Netir _{Hire vetted French freelance backend devs through mentored marketplace.}
NoBullshitConseil _{No-bullshit tech advisory. Founders & CTOs get straight answers.}	Qualneo _{Qualiopi LMS for French trainers. 32 indicators wired in, audit-ready.}	Recapro _{Private AI that transcribes meetings & drafts reports. Sovereign hosting.}

Interested in sponsoring? Get in touch

Upgrade

From 3.x to 4.x

# import using the fully qualified name.
use Fgribreau\MailChecker;

// ...
echo MailChecker::isValid('myemail@yopmail.com');

From 1.x to 3.x

Mailchecker public API has been normalized, here are the changes:

NodeJS/JavaScript: MailChecker(email) -> MailChecker.isValid(email)
PHP: MailChecker($email) -> MailChecker::isValid($email)
Python

import MailChecker
m = MailChecker.MailChecker()
if not m.is_valid('bla@example.com'):
  # ...

became:

import MailChecker
if not MailChecker.is_valid('bla@example.com'):
  # ...

MailChecker currently supports:

NodeJS (CommonJS, Instructions)
JavaScript (Client-Side, Instructions)
PHP (Instructions)
Python (Instructions)
Ruby (Instructions)
Rust (Instructions)
Elixir (Instructions)
Clojure (Instructions)
Go (Instructions)
Easily add support for your own language with MailChecker template system and send us a pull-request!

Usage

NodeJS

var MailChecker = require('mailchecker');

if(!MailChecker.isValid('myemail@yopmail.com')){
  console.error('O RLY !');
  process.exit(1);
}

if(!MailChecker.isValid('myemail.com')){
  console.error('O RLY !');
  process.exit(1);
}

JavaScript

<script type="text/javascript" src="MailChecker/platform/javascript/MailChecker.js"></script>
<script type="text/javascript">
if(!MailChecker.isValid('myemail@yopmail.com')){
  console.error('O RLY !');
}

if(!MailChecker.isValid('myemail.com')){
  console.error('O RLY !');
}
</script>

PHP


use Fgribreau\MailChecker;

require __DIR__ . '/vendor/autoload.php';

if(!MailChecker::isValid('myemail@yopmail.com')){
  die('O RLY !');
}

if(!MailChecker::isValid('myemail.com')){
  die('O RLY !');
}

Python

pip install mailchecker

# no package yet; just drop in MailChecker.py where you want to use it.
from MailChecker import MailChecker

if not MailChecker.is_valid('bla@example.com'):
    print("O RLY !")

Django validator: https://github.com/jonashaag/django-indisposable

Ruby

require 'mail_checker'

unless MailChecker.valid?('myemail@yopmail.com')
  fail('O RLY!')
end

Rust

 extern crate mailchecker;

assert_eq!(true, mailchecker::is_valid("plop@plop.com"));
assert_eq!(false, mailchecker::is_valid("\nok@gmail.com\n"));
assert_eq!(false, mailchecker::is_valid("ok@guerrillamailblock.com"));

Elixir

Code.require_file("mail_checker.ex", "mailchecker/platform/elixir/")

unless MailChecker.valid?("myemail@yopmail.com") do
  raise "O RLY !"
end

unless MailChecker.valid?("myemail.com") do
  raise "O RLY !"
end

Clojure

; no package yet; just drop in mailchecker.clj where you want to use it.
(load-file "platform/clojure/mailchecker.clj")

(if (not (mailchecker/valid? "myemail@yopmail.com"))
  (throw (Throwable. "O RLY!")))

(if (not (mailchecker/valid? "myemail.com"))
  (throw (Throwable. "O RLY!")))

Go

package main

import (
  "log"

  mail_checker "github.com/FGRibreau/mailchecker/v6/platform/go"
)

if !mail_checker.IsValid("myemail@yopmail.com") {
  log.Fatal("O RLY !");
}

if !mail_checker.IsValid("myemail.com") {
  log.Fatal("O RLY !")
}

Installation

go get github.com/FGRibreau/mailchecker/v6/platform/go

NodeJS/JavaScript

npm install mailchecker

Ruby

gem install ruby-mailchecker

PHP

composer require fgribreau/mailchecker

We accept pull-requests for other package manager.

Data sources

TorVPN

  $('td', 'table:last').map(function(){
    return this.innerText;
  }).toArray();

BloggingWV

  Array.prototype.slice.call(document.querySelectorAll('.entry > ul > li a')).map(function(el){return el.innerText});

... please add your own dataset to list.txt.

Regenerate libraries from list.txt

Just run (requires NodeJS):

npm run build

Development

Development environment requires docker.

# install and setup every language dependencies in parallel through docker
npm install

# run every language setup in parallel through docker
npm run setup

# run every language tests in parallel through docker
npm test

Backers

Maintainers

These amazing people are maintaining this project:

Francois-Guillaume Ribreau

Sponsors

No sponsors yet! Will you be the first?

Contributors

These amazing people have contributed code to this project:

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

Changelog

License

Unless stated otherwise all works are:

and licensed under:

MIT License

email-validation

email-verification

Project health

Overall

4.6/10

Maintained

10/10

Code review

5/10

OpenSSF Scorecard

npm

mailchecker

Latest release

6.0.21 · Jul 18, 2026

Releases this year

Significant stargazers

Snazzah

425 followers · starred Jun 2026

Uman Shahzad

103 followers · starred Nov 2019

Gergely Nemeth

626 followers · starred Sep 2015

Denis Ah-Kang

125 followers · starred Sep 2015

Similar repos

disposable-email-domains/disposable-email-domains

a list of disposable email domains

5,563

reacherhq/check-if-email-exists

Check if an email address exists without sending any email, written in Rust. Comes with a ⚙️ HTTP…

10,149

wesbos/burner-email-providers

A list of temporary email providers

1,196

egulias/EmailValidator

PHP Email address validator

11,638

disposable/disposable

A list of disposable/temporary email address domains

1,462

truemail-rb/truemail

🚀 Configurable framework agnostic plain Ruby 📨 email validator/verifier. Verify email via Regex,…

1,285

mailcheck/mailcheck

Reduce misspelled email addresses in your web apps.

7,936

JoshData/python-email-validator

A robust email syntax and deliverability validation library for Python.

1,449

FGRibreau/mailchecker

📫 Cross-language temporary (disposable/throwaway) email detection library. Covers 55 734+ fake email providers.

PHP

1,912

2,233 commits

updated Oct 5, 2026

twitter.com/FGRibreau

See the code

README

MailChecker

PyPI - Downloads

Crates.io

npm

Gem

Packagist

Cross-language email validation. Backed by a database of over 55 000 throwable email domains.

Validate the format of your email (uses validator.js email regex underneath and FILTER_VALIDATE_EMAIL for PHP)
Validate if the email is not a temporary mail (yopmail-like..., add your own dataset to list.txt)

This will be very helpful when you have to contact your users and you want to avoid errors causing lack of communication or want to block "spamboxes".

Sponsors

France-Nuage _{Sovereign French cloud for your signup pipeline. No vendor lock-in.}	Hook0 _{Send signup events as signed webhooks. Self-hosted, retry built-in.}	Natalia _{Catch the leads that signed up with bad emails — Natalia calls them back.}	Netir _{Hire vetted French freelance backend devs through mentored marketplace.}
NoBullshitConseil _{No-bullshit tech advisory. Founders & CTOs get straight answers.}	Qualneo _{Qualiopi LMS for French trainers. 32 indicators wired in, audit-ready.}	Recapro _{Private AI that transcribes meetings & drafts reports. Sovereign hosting.}

Interested in sponsoring? Get in touch

Upgrade

From 3.x to 4.x

# import using the fully qualified name.
use Fgribreau\MailChecker;

// ...
echo MailChecker::isValid('myemail@yopmail.com');

From 1.x to 3.x

Mailchecker public API has been normalized, here are the changes:

NodeJS/JavaScript: MailChecker(email) -> MailChecker.isValid(email)
PHP: MailChecker($email) -> MailChecker::isValid($email)
Python

import MailChecker
m = MailChecker.MailChecker()
if not m.is_valid('bla@example.com'):
  # ...

became:

import MailChecker
if not MailChecker.is_valid('bla@example.com'):
  # ...

MailChecker currently supports:

NodeJS (CommonJS, Instructions)
JavaScript (Client-Side, Instructions)
PHP (Instructions)
Python (Instructions)
Ruby (Instructions)
Rust (Instructions)
Elixir (Instructions)
Clojure (Instructions)
Go (Instructions)
Easily add support for your own language with MailChecker template system and send us a pull-request!

Usage

NodeJS

var MailChecker = require('mailchecker');

if(!MailChecker.isValid('myemail@yopmail.com')){
  console.error('O RLY !');
  process.exit(1);
}

if(!MailChecker.isValid('myemail.com')){
  console.error('O RLY !');
  process.exit(1);
}

JavaScript

<script type="text/javascript" src="MailChecker/platform/javascript/MailChecker.js"></script>
<script type="text/javascript">
if(!MailChecker.isValid('myemail@yopmail.com')){
  console.error('O RLY !');
}

if(!MailChecker.isValid('myemail.com')){
  console.error('O RLY !');
}
</script>

PHP


use Fgribreau\MailChecker;

require __DIR__ . '/vendor/autoload.php';

if(!MailChecker::isValid('myemail@yopmail.com')){
  die('O RLY !');
}

if(!MailChecker::isValid('myemail.com')){
  die('O RLY !');
}

Python

pip install mailchecker

# no package yet; just drop in MailChecker.py where you want to use it.
from MailChecker import MailChecker

if not MailChecker.is_valid('bla@example.com'):
    print("O RLY !")

Django validator: https://github.com/jonashaag/django-indisposable

Ruby

require 'mail_checker'

unless MailChecker.valid?('myemail@yopmail.com')
  fail('O RLY!')
end

Rust

 extern crate mailchecker;

assert_eq!(true, mailchecker::is_valid("plop@plop.com"));
assert_eq!(false, mailchecker::is_valid("\nok@gmail.com\n"));
assert_eq!(false, mailchecker::is_valid("ok@guerrillamailblock.com"));

Elixir

Code.require_file("mail_checker.ex", "mailchecker/platform/elixir/")

unless MailChecker.valid?("myemail@yopmail.com") do
  raise "O RLY !"
end

unless MailChecker.valid?("myemail.com") do
  raise "O RLY !"
end

Clojure

; no package yet; just drop in mailchecker.clj where you want to use it.
(load-file "platform/clojure/mailchecker.clj")

(if (not (mailchecker/valid? "myemail@yopmail.com"))
  (throw (Throwable. "O RLY!")))

(if (not (mailchecker/valid? "myemail.com"))
  (throw (Throwable. "O RLY!")))

Go

package main

import (
  "log"

  mail_checker "github.com/FGRibreau/mailchecker/v6/platform/go"
)

if !mail_checker.IsValid("myemail@yopmail.com") {
  log.Fatal("O RLY !");
}

if !mail_checker.IsValid("myemail.com") {
  log.Fatal("O RLY !")
}

Installation

go get github.com/FGRibreau/mailchecker/v6/platform/go

NodeJS/JavaScript

npm install mailchecker

Ruby

gem install ruby-mailchecker

PHP

composer require fgribreau/mailchecker

We accept pull-requests for other package manager.

Data sources

TorVPN

  $('td', 'table:last').map(function(){
    return this.innerText;
  }).toArray();

BloggingWV

  Array.prototype.slice.call(document.querySelectorAll('.entry > ul > li a')).map(function(el){return el.innerText});

... please add your own dataset to list.txt.

Regenerate libraries from list.txt

Just run (requires NodeJS):

npm run build

Development

Development environment requires docker.

# install and setup every language dependencies in parallel through docker
npm install

# run every language setup in parallel through docker
npm run setup

# run every language tests in parallel through docker
npm test