What do you want to do?
4 use cases
-
Launch a newsletter on MailCheap Cloud in minutes
Sign up for the hosted service and publish your first newsletter with a website, without running any servers.
- Mailcheap
- Claude Code
- Codex
- Cursor
- Content
- Beginner
View prompt
Using the marclou/mailcheap repository's MCP server with an API key for <your MailCheap Cloud account>, create a newsletter named <newsletter name> and draft a first issue about <topic>. Report the review checklist results and do not send anything. Verify that the draft appears in the dashboard before you finish.
-
Self-host a newsletter app on Vercel with Amazon SES
Deploy the open source MailCheap app to your own Vercel project and send through your own Amazon SES account.
View prompt
In the marclou/mailcheap repository, follow the self-hosting steps for Vercel with my MongoDB connection string in <MONGODB_URI> and my admin email in <ADMIN_EMAILS>. Report which environment variables are still missing and whether /api/health returns 200. Verify that SENDING_ENABLED is not set to true before the email provider is configured.
-
Move subscribers from beehiiv, Substack or Mailchimp
Import a CSV export from another newsletter tool with each reader's status and signup date kept.
- Mailcheap
- Claude Code
- Codex
- Cursor
- Content
- Beginner
View prompt
Using the marclou/mailcheap MCP server with my API key, import the CSV at <path to export file> into the newsletter <newsletter name>. Report how many contacts were imported and how many were left out by reason. Do not send any issue. Verify that the reader count in the dashboard matches the import report.
-
Have an AI agent draft and review a newsletter issue
Let Claude Code, Codex or Cursor write an issue through the MCP server and fix review warnings before you approve a send.
- Mailcheap
- Claude Code
- Codex
- Cursor
- Content
- Intermediate
View prompt
Using the marclou/mailcheap MCP server with my API key and my notes in <notes file>, draft an issue for the newsletter <newsletter name>. Fix all review warnings and report the remaining ones. Do not send it. Verify that the draft exists in the dashboard and that the review list is empty or explained.
How to use Mailcheap
- Check you have what it needs: A MailCheap Cloud account at mailcheap.ai, or a server with Node.js 22+ and a MongoDB database for self-hosting; For self-hosting: an Amazon SES or PostShiba account, plus Upstash QStash for background sending; A list of contacts with consent to email them, or an export CSV from beehiiv, Substack, Mailchimp or another supported tool.
- Open marclou/mailcheap on GitHub and read the README and license.
- Sign up at https://mailcheap.ai. Plans start at $19 a month for 20,000 emails.
- Create a newsletter. Without your own domain, it sends from a shared address on the Mailcheap.ai subdomain, and its website sits on a free subdomain of Mailcheap.ai.
- Write an issue in the editor, or send Markdown or complete HTML through the API.
- Open the review step and fix what it flags: subject, preview text, unsubscribe link, Gmail's 100 KB clip, postal address and sender.
These steps come from our top use case, Launch a newsletter on MailCheap Cloud in minutes, which also has a copy-paste agent prompt.
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forSolo creators, small publishers and developers who want to run a newsletter cheaply, either on the hosted MailCheap Cloud or on their own server.
- Why it is hot
- LanguageJavaScript
- Sourcegithub.com/marclou/mailcheap · Back to Hot repos
Requirements
- A MailCheap Cloud account at mailcheap.ai, or a server with Node.js 22+ and a MongoDB database for self-hosting
- For self-hosting: an Amazon SES or PostShiba account, plus Upstash QStash for background sending
- A list of contacts with consent to email them, or an export CSV from beehiiv, Substack, Mailchimp or another supported tool
- An AI agent or API key if you want an agent to write or send issues
Add this badge to your README
Maintain Mailcheap? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/marclou-mailcheap/?utm_source=github&utm_medium=badge&utm_campaign=marclou-mailcheap)
HTML
<a href="https://dedupedai.com/use-cases/marclou-mailcheap/?utm_source=github&utm_medium=badge&utm_campaign=marclou-mailcheap"><img src="https://dedupedai.com/badge/marclou/mailcheap.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Mailcheap
What is Mailcheap?
MailCheap is an open source newsletter app that charges for emails sent rather than dormant subscribers, runnable as a hosted service or self-hosted with Amazon SES or PostShiba. It is an open-source project on GitHub: https://github.com/marclou/mailcheap.
Who is Mailcheap for?
Solo creators, small publishers and developers who want to run a newsletter cheaply, either on the hosted MailCheap Cloud or on their own server.
What can I do with Mailcheap?
4 use cases so far, for example: Launch a newsletter on MailCheap Cloud in minutes; Self-host a newsletter app on Vercel with Amazon SES; Move subscribers from beehiiv, Substack or Mailchimp. Each has steps and a copy-paste agent prompt.
What do I need to run Mailcheap?
A MailCheap Cloud account at mailcheap.ai, or a server with Node.js 22+ and a MongoDB database for self-hosting; For self-hosting: an Amazon SES or PostShiba account, plus Upstash QStash for background sending; A list of contacts with consent to email them, or an export CSV from beehiiv, Substack, Mailchimp or another supported tool; An AI agent or API key if you want an agent to write or send issues.
What are alternatives to Mailcheap?
Other hot AI repos in Content: Hermes Speech, Wonder Pill, Comfy UI Mini Max H3 Image Studio, GPT Image 2 5 Prompt Atlas, Genart Skill.
Is Mailcheap safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.