# emailmd

Converts markdown into email-ready HTML, lints drafts for deliverability issues, and builds charts without images.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1383
- Author: anypost
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/anypost/emailmd
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/mcp/emailmd

## What it does

The server converts markdown into responsive HTML and plain-text alternatives that render predictably in Outlook, Apple Mail, and Gmail. It runs MJML 5 under the hood. It exposes three MCP tools: `render` to produce email-safe markup, `lint` to detect deliverability risks before sending, and `read_docs` to check syntax reference.

Metrics such as sparklines, KPI tiles, and bar charts are built entirely out of text glyphs and table cells instead of SVG or linked images. They remain visible even if a recipient's mail reader suppresses external assets. In the plain-text part, data remains formatted instead of collapsing into a raw list of figures.

Local execution via `npx` requires Node 20+ due to MJML 5 dependencies. When you want to avoid local runtime requirements, connect directly to the hosted HTTP endpoint instead.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://www.emailmd.dev/api/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http emailmd https://www.emailmd.dev/api/mcp
```

2. **Platform CLI**
```bash
claude mcp add emailmd -- npx -y emailmd
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add emailmd --url https://www.emailmd.dev/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add emailmd -- npx -y emailmd
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "emailmd": {
            "url": "https://www.emailmd.dev/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "emailmd": {
            "command": "npx",
            "args": [
                "-y",
                "emailmd"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "emailmd": {
            "type": "http",
            "url": "https://www.emailmd.dev/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "emailmd": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "emailmd"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http emailmd https://www.emailmd.dev/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add emailmd npx -y emailmd
```

## When to use it
- compile markdown drafts into responsive HTML tested across major email clients
- audit newsletter markup for potential deliverability warnings before sending
- draw charts and progress indicators without external image hosting
- generate both HTML and plain-text MIME parts in one pass

## Example prompts
- Convert newsletter.md into email-safe HTML and produce the plain-text version.
- Lint this email draft with emailmd to catch deliverability issues before dispatching.
- Check the emailmd documentation for directives to render a bar chart.

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51091
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16062
- [mcp-server-chart](https://affpapa.org/en/nevibecode/mcp/mcp-server-chart.md) — MCP server · ★ 4402
- [Dembrandt](https://affpapa.org/en/nevibecode/mcp/dembrandt.md) — MCP server · ★ 3821
- [RevoGrid DataGrid MCP Pro](https://affpapa.org/en/nevibecode/mcp/revogrid-datagrid-mcp-pro.md) — MCP server · ★ 3450

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md