# Easy Email Builder

> Easy Email Builder is an open-source MCP server for communication. Local MCP server that lets an AI assistant build and preview HTML email templates. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://shahkarkhan440.github.io/Easy-Email-Builder/
- **Repository:** https://github.com/shahkarkhan440/easy-email-builder/tree/HEAD/mcp
- **MCP Registry name:** io.github.Shahkarkhan440/easy-email-builder
- **Categories:** communication, design and media, marketing and SEO
- **Listing updated:** 2026-11-15

## About

The assistant writes the email template; this server validates it, renders the final HTML and hands back a preview link that opens the result in a browser-based visual editor for further tweaking and export. It also returns the template's variables, such as a first name or an unsubscribe link, with their fallback values, and can output the editor JSON for loading into the EmailBuilder React component.

The build step warns about things that tend to break in Outlook or Gmail: nested columns, oversized images, unsupported CSS and messages large enough for Gmail to clip. A block reference tool teaches the assistant the template format, and 31 starter templates give it something to adapt.

It runs locally over stdio from the npm package, so it works in Claude Desktop (one-click extension), Claude Code, Codex, VS Code, Gemini CLI, Cursor and similar clients, but not in web chat apps that only accept hosted URLs. Preview links point at a public demo editor unless you set your own editor URL.

## Features

- **Render to HTML:** Validates a template and produces the final email HTML.
- **Visual editor preview:** Gives a link that opens the email in the visual editor for manual edits.
- **Client compatibility warnings:** Flags nested columns, big images, unsupported CSS and Gmail clipping.
- **Variable listing:** Reports placeholders and their fallback values.
- **31 starter templates:** Offers templates plus header and footer ids to adapt.
- **Self-hosted editor option:** An environment variable points preview links at your own editor.

## Good for

- Draft a welcome email with a discount code and a first-name variable
- Adapt a starter template to a brand's colours
- Check an email for Outlook and Gmail problems before sending
- Export editor JSON for an app that embeds the email builder

## Install

### Claude Code (Terminal)

```sh
claude mcp add easy-email-builder -- npx -y easy-email-builder-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "easy-email-builder": {
      "command": "npx",
      "args": [
        "-y",
        "easy-email-builder-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "easy-email-builder": {
      "command": "npx",
      "args": [
        "-y",
        "easy-email-builder-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "easy-email-builder": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "easy-email-builder-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "easy-email-builder": {
      "command": "npx",
      "args": [
        "-y",
        "easy-email-builder-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "easy-email-builder": {
      "command": "npx",
      "args": [
        "-y",
        "easy-email-builder-mcp"
      ]
    }
  }
}
```

## Tools

- `get_block_reference`: The template format: blocks, properties, colors, variables.
- `list_templates`: Lists 31 starter templates and the built-in header and footer ids.
- `get_template`: Returns a starter template to adapt.
- `build_email`: Validates a template, renders HTML, lists variables and returns a preview link.

## FAQ

### Does it work with ChatGPT or claude.ai on the web?

No. It runs on your machine, so use a client that supports local MCP servers.

### What do I need to install it?

Node.js 18+ for the command-line setups; the Claude Desktop extension needs no Node install.

### Where do preview links open?

In the public demo editor by default, or your own editor if you set EASY_EMAIL_BUILDER_EDITOR_URL.

### Is Easy Email Builder free?

Yes. Easy Email Builder is open source, so you can use and self-host it for free.

### How do I add Easy Email Builder to Claude Code?

Run this command in your terminal: claude mcp add easy-email-builder -- npx -y easy-email-builder-mcp

### What are the best alternatives to Easy Email Builder?

The closest alternatives to Easy Email Builder are HyperFrames by HeyGen, ffmpeg-skill, Google Ads + Meta Ads + SEO/GEO MCP, Calven and MCP.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/easy-email-builder
