MCP Server

Active

MIT

emailmd MCP Server

dev.emailmd/emailmd

Convert markdown to email-safe HTML with linting and preview tools.

What is the emailmd MCP server?

The emailmd MCP server renders markdown into responsive, email-safe HTML that works across Gmail, Outlook, Apple Mail, and other clients. It exposes tools to convert markdown to HTML, lint emails for deliverability issues, and access emailmd syntax documentation.

emailmd simplifies email template creation by converting markdown into production-ready HTML that renders correctly across all major email clients. Use it to write email content in simple markdown syntax, automatically generate plain-text versions, and catch deliverability problems before sending.

How to install emailmd

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "emailmd": {
      "command": "npx",
      "args": [
        "-y",
        "emailmd"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "emailmd": {
      "command": "npx",
      "args": [
        "-y",
        "emailmd"
      ]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "emailmd": {
      "command": "npx",
      "args": [
        "-y",
        "emailmd"
      ]
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "emailmd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "emailmd"
      ]
    }
  }
}

Claude Code

claude mcp add emailmd -- npx -y emailmd

Tools & capabilities

Tools this server exposes to the agent.

render — Convert markdown to email-safe HTML and plain text versions
lint — Check emails for deliverability problems without rendering
read_docs — Look up emailmd syntax and features

Use cases

Generate responsive email templates from markdown without manual HTML
Validate email content for client compatibility and deliverability issues before sending
Create plain-text and HTML versions of emails simultaneously
Build email templates with buttons, styling, and responsive layouts using simple markdown syntax
Preview and test email rendering across different email clients

emailmd MCP server FAQ

What is emailmd?

emailmd is a tool that converts markdown into responsive, email-safe HTML compatible with Gmail, Outlook, Apple Mail, Yahoo, and other email clients. It also provides linting for deliverability issues and syntax documentation.

Is emailmd free?

Yes, emailmd is open-source under the MIT license. The MCP server is available both as a hosted service and for local installation.

How do I install the emailmd MCP server?

Install via npm with `npm install emailmd`, then run `npx emailmd mcp` for local stdio transport, or use the hosted endpoint at https://www.emailmd.dev/api/mcp for Streamable HTTP.

What email clients does emailmd support?

emailmd renders correctly across Gmail, Outlook, Apple Mail, Yahoo, and all other major email clients with responsive, email-safe HTML.

Does emailmd require authentication?

No authentication is required. The hosted MCP endpoint and local installation are both freely accessible.

Can I use emailmd with React?

Yes, the `@emailmd/react` package provides a live-preview hook, email preview component, and a full builder component for integration into your own applications.

README (reference)

Source of truth, from the repository.

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.

emailmd

Install

npm install emailmd

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 part

v0.3.0 migration: render() is now async. Update calls from render(md) to await render(md). Requires Node 20+ (MJML 5).

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" | emailmd

Run 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 emailmd

Learn 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 mcp

Published 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.txt

Contributing

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

Built with MJML under the hood
Sponsored by Anypost

License

View repository →