# emailmd MCP server

> Renders markdown as email-safe HTML, lints email drafts for deliverability issues, and previews emails for AI clients.

- Repository: https://github.com/anypost/emailmd
- Page: https://hostedmcp.org/servers/anypost/emailmd
- Transport: stdio, remote
- Stars: 1392
- License: MIT
- Latest version: 0.13.3

## Install

### Claude Code

```sh
claude mcp add emailmd -- npx -y emailmd
```

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

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

### VS Code CLI

```sh
code --add-mcp '{"name":"emailmd","type":"stdio","command":"npx","args":["-y","emailmd"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add emailmd -- npx -y emailmd
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.emailmd]
command = "npx"
args = ["-y", "emailmd"]
```

### Gemini CLI

```sh
gemini mcp add -s user emailmd npx -- -y emailmd
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## FAQ

### What tools does the emailmd MCP server expose?

It exposes three tools: render (markdown to email-safe HTML), lint (flag deliverability problems without rendering), and read_docs (look up emailmd syntax).

### Does emailmd produce plain text versions of emails?

Yes. render() returns both html (complete email-safe HTML) and text (a plain text version for the text/plain MIME part), and the CLI has a --text flag.

### What email clients does emailmd's HTML support?

The generated responsive HTML is designed to work across Gmail, Outlook, Apple Mail, Yahoo, and other clients.
