emailmd MCP
The emailmd MCP server: an agent builds an email from markdown, lints deliverability and returns a preview link.
- 1,390 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- Stores no data and sends no emails; the hosted version receives the email text for rendering.
Install
- Works in
Manual install
npm install emailmdThe library and the command-line tool.
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Stores no data and sends no emails; the hosted version receives the email text for rendering.
This is third-party code. Review the repository files before installing.
What it does
emailmd converts markdown into responsive email HTML that renders in Gmail, Outlook, Apple Mail and Yahoo. The MCP server gives an assistant three tools. `render` returns finished HTML, the plain-text part of the email, metadata, warnings, the size and a preview link. `lint` finds deliverability problems without rendering. `read_docs` fetches the emailmd.dev documentation so the agent does not guess at syntax. The preview link leads to the builder: the markdown is compressed into the URL fragment and so never reaches the server. The hosted server runs over Streamable HTTP at `https://www.emailmd.dev/api/mcp` with no authorization and no storage. Locally it starts with `npx emailmd mcp` over stdio, and the `--partials` flag preloads email partials.
Who it is for. Developers of newsletters and product emails who write templates in markdown and want an agent to build and check them before sending.
Good fit when
- An agent writes a welcome email with a button and gets HTML and a text version at once.
- A draft is checked for deliverability problems before it goes out in a campaign.
- A team shares a preview link where the email shows in light and dark themes.
- A chart or a table of metrics is added to an email from a plain markdown list.
Not a fit when
- You need to send emails: emailmd only prepares HTML and text.
- The layout is assembled in a visual editor with no markdown.
- The email source exceeds 256 KB, the limit of the hosted server.
Example request
Write a welcome email with a "Get started" button, lint it for deliverability problems and give me a preview link.MCP
- Transport
- stdio, http
- Authentication
- not required
Limitations
The hosted server needs no authorization and stores nothing, but accepts markdown and partials up to 256 KB each. Running locally needs Node.js 20 or newer. The `render` function has been asynchronous since version 0.3.0. The server only builds and checks an email, so sending has to be set up separately. A preview opens in the builder by link, and anyone who has the link can see the email. Gmail clips emails over 102 KB, so keep the size reasonable.
How to disable. Remove the emailmd entry from the MCP configuration (`claude mcp remove emailmd`). A local run installed nothing else, since the package is fetched through `npx`.
FAQ
How do I connect emailmd to Claude Code?
Run `claude mcp add --transport http emailmd https://www.emailmd.dev/api/mcp` for the hosted server or `claude mcp add emailmd -- npx emailmd mcp` for the local one.
What does the `render` tool return?
A complete HTML document, the plain-text part, frontmatter metadata, render warnings, the output size in bytes and a `previewUrl` link.
Does my text reach the server in a preview?
No. The markdown is compressed into the URL fragment, which is not sent to the server, and the builder shows the email in your browser.
How do I use my own partials?
Start the local server with `--partials ./partials`. Partials are preloaded for every `render` and `lint` call.
Does it work in Cursor and VS Code?
Yes. There are one-click install buttons, or an `emailmd` entry with the server address in the MCP configuration. Claude.ai, Claude Desktop and ChatGPT also work as a custom connector.
Discussion
No questions or reviews yet.
Related
MCP serversAn open-source email newsletter app where every dashboard action is available to an agent through MCP
SendPulse MCP server
sendpulse-mcp
An MCP server for SendPulse: email campaigns, mailing lists, transactional mail via SMTP and web push notifications
Wenyan MCP
文颜 MCP Server
An MCP server that formats Markdown with ready themes and saves the article to a WeChat official account draft
SendPulse MCP server
SendPulse MCP
SendPulse's official remote MCP server: statistics, campaigns and user data through an agent chat
MCP server of the OpenPost social scheduler: an agent reviews the calendar and accounts, drafts, schedules and publishes posts and triages comments
Official hosted RuSender MCP server with ready skills for email campaigns, contact lists and analytics
README in short
The `emailmd` package contains a library, a command-line tool and an MCP server, and `@emailmd/react` adds a preview hook and a builder component. MIT licensed.