Easy Email Builder
Design HTML email templates with AI: render to HTML and open them in a visual editor
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
easy-email-builder-mcpclaude mcp add easy-email-builder -e 'EASY_EMAIL_BUILDER_EDITOR_URL=<EASY_EMAIL_BUILDER_EDITOR_URL>' -- npx -y easy-email-builder-mcp@0.1.3
{
"mcpServers": {
"easy-email-builder": {
"command": "npx",
"args": [
"-y",
"easy-email-builder-mcp@0.1.3"
],
"env": {
"EASY_EMAIL_BUILDER_EDITOR_URL": "<EASY_EMAIL_BUILDER_EDITOR_URL>"
}
}
}
}
Environment variables
EASY_EMAIL_BUILDER_EDITOR_URLEditor URL for preview links, if you host the editor yourself. Defaults to the public demo.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Easy Email Builder
A drag-and-drop email template editor for React.
- Visual editor with text, image, button, video, socials, columns and more
- Export to HTML and JSON
- Locked header and footer with ready-made templates
- 31 starter email templates
- Image and video upload hooks
- MCP server: design emails with Claude, Cursor, Codex and other AI agents
Use with AI agents (MCP)
Add Easy Email Builder to your favorite AI agent as an MCP server, then ask it to design an email. It returns the email HTML and a link that opens the result in the visual editor.
Claude Desktop: download the one-click extension easy-email-builder.mcpb, double-click it and click Install.
Claude Code
claude mcp add easy-email-builder --scope user -- npx -y easy-email-builder-mcp
OpenAI Codex
codex mcp add easy-email-builder -- npx -y easy-email-builder-mcp
VS Code (GitHub Copilot)
code --add-mcp '{"name":"easy-email-builder","command":"npx","args":["-y","easy-email-builder-mcp"]}'
Gemini CLI
gemini mcp add easy-email-builder npx -y easy-email-builder-mcp
Cursor, Windsurf, Cline and other MCP clients: add to the client's MCP config:
{
"mcpServers": {
"easy-email-builder": {
"command": "npx",
"args": ["-y", "easy-email-builder-mcp"]
}
}
}
Config file locations and troubleshooting: see the MCP server README.
Install
npm install easy-email-builder
Peer dependencies (React 18 and MUI 5):
npm install react@18 react-dom@18 @mui/material@5 @mui/icons-material@5 @emotion/react @emotion/styled react-syntax-highlighter
Usage
Give the editor a container with a fixed height:
import { EmailBuilder } from 'easy-email-builder';
export default function App() {
return (
<div style={{ height: '100vh' }}>
<EmailBuilder
onChange={(json, html) => console.log(json, html)}
imageUploadHandler={async (file) => {
// upload the file and return its URL
return 'https://example.com/image.png';
}}
/>
</div>
);
}
Main props
| Prop | Description |
|---|---|
initialDocument | Starting template JSON |
onChange(json, html) | Called on every edit |
imageUploadHandler(file) | Upload an image, return its URL |
videoUploadHandler(file) | Upload a video, return its URL |
initialName / onNameChange | Template name |
showJsonFeatures | Show the JSON tab, import and export (default true) |
editingSlot | 'header' or 'footer': open the editor locked to that region only; its HTML output contains just that region |
theme | Custom MUI theme |
Use a ref to read the current template:
const ref = useRef<EmailBuilderRef>(null);
ref.current?.getData((json, html) => save(json, html));
An HTML-only code editor is also available:
import { HtmlEditor } from 'easy-email-builder/html-editor';
Development
pnpm install
pnpm dev # preview app (docs/)
pnpm build:lib # build the library to dist/
License
MIT. Author: shahkar khan.
Frequently asked questions
What is Easy Email Builder?
Design HTML email templates with AI: render to HTML and open them in a visual editor
How do I install Easy Email Builder?
It runs on your machine. In Claude Code: claude mcp add easy-email-builder -e 'EASY_EMAIL_BUILDER_EDITOR_URL=<EASY_EMAIL_BUILDER_EDITOR_URL>' -- npx -y easy-email-builder-mcp@0.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Easy Email Builder need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Easy Email Builder open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Easy Email Builder?
It is published by Shahkarkhan440. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.