emailmd
The emailmd MCP server lets AI assistants render, lint, and look up docs for emailmd markdown emails.
render: Converts emailmd markdown into email-safe HTML, a plain-text MIME part, frontmatter metadata, warnings, byte count, and a live preview URL; optionally minifies HTML and supports named partials.
lint: Checks markdown for deliverability, accessibility, and readability problems such as missing alt text, http:// links, Gmail's 102KB clip limit, generic link text, and spam-trigger phrases.
read_docs: Fetches emailmd documentation pages on demand to verify syntax; calling with no arguments returns the docs index.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
emailmd
Write markdown. Ship emails. No HTMHELL.
emailmd converts markdown into responsive, email-safe HTML that works across Gmail, Outlook, Apple Mail, Yahoo, and every other client.

Install
npm install emailmdRelated MCP server: mail-report-mcp
Quick Start
import { render } from "emailmd";
const { html, text } = await render(`
# Welcome!
Thanks for signing up.
[Get Started](https://example.com){button}
`);
// html → complete email-safe HTML
// text → plain text version for text/plain MIME partv0.3.0 migration:
render()is now async. Update calls fromrender(md)toawait render(md). Requires Node 20+ (MJML 5).
Charts & Data
Bar charts, progress meters, sparklines, KPI tiles, step trackers, and star ratings, each written as a plain markdown list:
::: chart
- Spotify: 16,900
- Apple Podcasts: 12,400
- Web player: 6,200
- RSS: 2,900
:::
They are drawn from table cells and text glyphs rather than images or SVG, so they still render when the client blocks remote images, and they redraw themselves in the plain-text part instead of collapsing to a list of numbers. See the directives reference.
CLI
emailmd also ships with a command-line interface.
# Render to HTML
emailmd input.md
# Write to file
emailmd input.md -o output.html
# Plain text output
emailmd input.md --text
# Pipe from another command
echo "# Hello" | emailmdRun emailmd --help for all options.
React
@emailmd/react provides a live-preview hook (useEmailmd), an <EmailPreview /> iframe component, and <EmailmdBuilder /> — the full builder as a drop-in component for your own app.
npm install @emailmd/react emailmdLearn More
Docs — full syntax reference, theming, frontmatter, directives, and API
Templates — ready-made email templates you can copy and customize
Builder — live editor to write and preview emails in your browser
MCP
emailmd ships a Model Context Protocol server, so an AI assistant can render, lint, and preview emails for you. It exposes three tools — render (markdown to email-safe HTML), lint (flag deliverability problems without rendering), and read_docs (look up emailmd syntax) — over either transport:
# Hosted (Streamable HTTP)
https://www.emailmd.dev/api/mcp
# Or run it locally over stdio
npx emailmd mcpPublished to the official MCP registry as dev.emailmd/emailmd. See the MCP docs for per-client setup.
AI
Prefer plain context over tools? emailmd is just markdown, so AI is great at writing templates. Feed the full docs to your AI tool:
https://www.emailmd.dev/llms-full.txtContributing
Contributions are welcome! Feel free to open an issue or submit a pull request.
emailmd is under active development. The API may change between minor versions until we hit 1.0 — breaking changes are always called out in the changelog. See Stability & Versioning for what the semver contract covers.
Acknowledgements
License
MIT
Available Tools
3 toolslintLint an emailARead-onlyIdempotentInspect
Check emailmd markdown for deliverability, accessibility, and readability problems without rendering it: missing alt text, http:// links, Gmail's 102KB clip limit, generic link text, spam-trigger phrases, and more. Fix warnings before sending; suggestions are sometimes intentional (e.g. transactional emails without an unsubscribe link).
Inputs: markdown (required), partials.
read_docsRead emailmd docsARead-onlyIdempotentInspect
Fetch emailmd documentation from emailmd.dev. Call with no arguments for the index of all pages; pass page to read one (e.g. 'buttons', 'frontmatter', 'theme', 'directives/hero'). Read the relevant page before using syntax you are not sure about.
Inputs: page.
renderRender an emailARead-onlyIdempotentInspect
Render emailmd markdown into email-safe HTML. Returns html (the complete email document), text (the plain-text MIME part), meta (frontmatter), warnings (non-fatal repairs made while rendering; aim for none), htmlBytes, and previewUrl (a live browser preview of this exact document to share with the user).
Inputs: markdown (required), minify, partials.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
render (produce HTML/text output), lint (static analysis of deliverability/accessibility), and read_docs (fetch documentation) each target a completely distinct action with no overlap. An agent can trivially decide which to call based on intent.
All names are lowercase and verb-based, but 'render' and 'lint' are bare verbs while 'read_docs' uses verb_noun. The deviation is minor and still readable/unpredictable in a harmless way.
Three tools is at the low end of the ideal range but each earns its place: rendering, linting, and documentation lookup are the essential operations for this domain. No filler or redundant tools.
The render-lint-docs trio covers the full compile-and-validate lifecycle for email markdown, with meta/warnings/previewUrl as useful outputs. Minor gaps exist (no explicit theme/schema listing or auto-fix tool) but these are workable via read_docs.
Maintenance
Related MCP Connectors
Design on-brand emails with your AI, preview them in chat, and send through server-side guardrails.
Email validation, link previews and article-to-Markdown extraction for AI agents
Analyze, audit, fix and diff HTML, MJML, Maizzle and React Email across 21 email clients.
Deploy what Claude builds to a live link: previews, who-opened-it links, stats, forms, domains.
Related MCP Servers
AlicenseNot gradedqualityCmaintenanceEnables AI agents to send emails, perform IP lookups, and convert files to Markdown.6MIT- AlicenseNot gradedqualityCmaintenanceEnables generating email-safe HTML reports from Markdown with inline styles, embedded screenshots, and severity pills, then sending them over SMTP with delivery tracking and retries.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to check email HTML for delivery-breaking problems before sending, returning structured diagnostics with rule id, severity, line and column, along with a tool that lists every available rule. It runs with no filesystem, network or environment access, so agents can validate markup without gaining new permissions.34 npm5MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to read, search, send, schedule, and organize email across multiple IMAP/SMTP accounts, including drafts, provider-aware labels, real-time inbox watching, verification-code capture, and analytics. Supports OAuth2, calendar extraction, and both local stdio and networked Streamable HTTP access.31 npmISC