{"id":14701017,"url":"https://github.com/customeros/mailsherpa","last_synced_at":"2025-10-19T10:38:00.909Z","repository":{"id":251720668,"uuid":"837354260","full_name":"customeros/mailsherpa","owner":"customeros","description":"CLI to verify an if an email address is deliverable.  Uses SMTP to validate email addresses without sending an email.","archived":false,"fork":false,"pushed_at":"2025-03-10T09:16:13.000Z","size":583,"stargazers_count":20,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-03T09:11:12.267Z","etag":null,"topics":["email","email-validation","email-verfication","email-verification","email-verifier","emails","emails-checker","go","golang","smtp","smtp-checker"],"latest_commit_sha":null,"homepage":"https://docs.customeros.ai","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/customeros.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-02T19:18:00.000Z","updated_at":"2025-03-10T09:15:59.000Z","dependencies_parsed_at":"2024-08-11T20:30:00.148Z","dependency_job_id":"5e4b3a6b-d008-42f4-8fe7-8df67f2d9b7b","html_url":"https://github.com/customeros/mailsherpa","commit_stats":null,"previous_names":["customeros/mailhawk","customeros/mailsherpa"],"tags_count":51,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/customeros%2Fmailsherpa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/customeros%2Fmailsherpa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/customeros%2Fmailsherpa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/customeros%2Fmailsherpa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/customeros","download_url":"https://codeload.github.com/customeros/mailsherpa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248799713,"owners_count":21163398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["email","email-validation","email-verfication","email-verification","email-verifier","emails","emails-checker","go","golang","smtp","smtp-checker"],"created_at":"2024-09-13T11:01:32.756Z","updated_at":"2025-10-19T10:38:00.798Z","avatar_url":"https://github.com/customeros.png","language":"Go","funding_links":[],"categories":["Deliverability"],"sub_categories":["Email Verification"],"readme":"\u003cbr /\u003e\u003cbr /\u003e\n\n\u003cp align=\"center\"\u003e\u003cimg align=\"center\" src=\"https://customer-os.imgix.net/companies/logos/mailsherpa_logo.png\" height=\"200\" alt=\"mailsherpa\" /\u003e\u003c/p\u003e\n\u003ch1 align=\"center\"\u003eMailSherpa\u003c/h1\u003e\n\u003ch4 align=\"center\"\u003eA CLI for verifying email address deliverability over SMTP without sending an email.\u003c/h4\u003e\n\n\u003cbr /\u003e\u003cbr /\u003e\u003cbr /\u003e\n\n## 👉 [Live Demo: https://customeros.ai](https://customeros.ai/is/email-verification)\n\nThis 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 matt@customeros.ai.\n\n\u003cbr /\u003e\n\n## Installation \n\nIf you want to use our install script, you can run the following command:\n\n```\ncurl -sSL https://mailsherpa.sh/install.py | python3\n```\notherwise, follow the diretions below:\n\nDownload the appropriate CLI tarball for your OS:\n\n```\nwget mailsherpa.sh/mailsherpa-linux-arm64.tar.gz\nwget mailsherpa.sh/mailsherpa-linux-amd64.tar.gz\nwget mailsherpa.sh/mailsherpa-macos.tar.gz\n```\n\nExtract the binary:\n\n```\ntar -xzf filename.tar.gz\n```\n\n4. Test to make sure everything is working\n\n```\n./mailsherpa version\n```\n\n## Set env variables\n\nSet the `MAIL_SERVER_DOMAIN` environment variable.  See the `Mail Server setup guide` section below for more details:\n\n```\nexport MAIL_SERVER_DOMAIN=example.com\n```\n\n\n## Mail Server setup guide\n\nYou 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. \n\nHowever, 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.\n\nTo get around this, you need a server with access to port 25 (we like Hetzner or OVH), configured to look like a mail server.  \n\nIf you would like help setting this up, ping me at matt@customeros.ai\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcustomeros%2Fmailsherpa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcustomeros%2Fmailsherpa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcustomeros%2Fmailsherpa/lists"}