Skip to content
MCP server

HTML Email Playbook

Gives AI clients tested rules and components for HTML email that renders in Outlook

Install
Pricing
Open source
Platforms
CLI, Web, API
Runs
Locally or Remotely
Version
0.8.0
Listing updated
3 days ago

About HTML Email Playbook

HTML Email Playbook is an open-source MCP server for communication. It can run locally on your machine or as a hosted remote server.

Language models tend to reach for flex and grid, hard-code table widths and skip the VML fallback that Outlook buttons need. This server swaps that guesswork for lookup tools: the model pulls the playbook's rules and component patterns, then builds the email from them. The README says it is a knowledge server only, with no inbox access and no network calls of its own, and has one dependency (the official MCP SDK) and no postinstall scripts.

A typical session starts with list_categories, then get_playbook_rules (a checklist of roughly 16 KB), get_rule for a specific page such as responsive compatibility, and list_components with get_component for items like buttons. The playbook behind it covers table layout, inline styles, Outlook MSO conditional comments, RTL, dark mode, preheaders and the 102 KB Gmail clip limit, all written by one UI engineer, Osama Hassouna, and tested against Outlook on Windows, Gmail and Apple Mail.

It installs from npm, also ships a CLI for scripting, and has a hosted endpoint. A local copy older than 90 days prints an update note, which an environment variable turns off. A separate web Playground turns a pasted screenshot into email HTML.

Install

Run in a terminal

claude mcp add --transport http email-playbook-mcp https://docs.osamahassouna.com/api/mcp

Add to Settings → Connectors → Add custom connector

https://docs.osamahassouna.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "email-playbook-mcp": {
      "url": "https://docs.osamahassouna.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "email-playbook-mcp": {
      "type": "http",
      "url": "https://docs.osamahassouna.com/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "email-playbook-mcp": {
      "serverUrl": "https://docs.osamahassouna.com/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "email-playbook-mcp": {
      "type": "http",
      "url": "https://docs.osamahassouna.com/api/mcp"
    }
  }
}

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

list_categories
Lists the playbook's page slugs to orient the model.
get_playbook_rules
Returns every page's rules, for example as a checklist.
get_rule
Returns the rules for one page by slug.
list_components
Lists the available component patterns.
get_component
Returns the pattern for one component, such as buttons.

What it does

Rule lookup tools
The model fetches exact email-rendering rules by category or page instead of guessing.
Component patterns
Get patterns such as bulletproof buttons, including whether VML is required.
No mailbox access
The tools return playbook content only and never read or send mail.
CLI included
A second binary queries the same content for scripts.
Staleness notice
Bundled rules older than 90 days trigger a note to update.
Hosted or local
Run over stdio from npm or use the hosted Streamable HTTP endpoint.

Good for

  • Turn a design into Outlook-safe table-based HTML
  • Make an AI client add the VML fallback for buttons
  • Check an email against Gmail's 102 KB clip limit
  • Add dark mode and preheader text correctly
  • Query individual email components from a script

Pricing

Open source

Open source; free to use

Prices change. Check docs.osamahassouna.com before you buy.

HTML Email Playbook FAQ

Does it touch my email account?

No. The README says it never reads or sends mail and asks for no Gmail, Outlook or SMTP credentials.

How do I install it?

Run npx -y email-playbook-mcp@latest or install it globally with npm; the README advises not pinning a version.

Which clients work?

Claude Desktop, Cursor, Cline, Continue, Windsurf and other MCP clients that start a command.

Is there a hosted version?

Yes, at https://docs.osamahassouna.com/api/mcp.

What if my local rules are old?

After 90 days the server adds an update note; set EMAIL_PLAYBOOK_NO_STALE_NOTICE=1 to turn it off.

Is HTML Email Playbook free?

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

How do I add HTML Email Playbook to Claude Code?

Run this command in your terminal: claude mcp add --transport http email-playbook-mcp https://docs.osamahassouna.com/api/mcp

What are the best alternatives to HTML Email Playbook?

The closest alternatives to HTML Email Playbook are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to HTML Email Playbook

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory