H
HTML Email Playbook
Teaches AI to write HTML email that renders in Outlook, Gmail, and Apple Mail. 19 rules, 6 comps.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Install Config Generator
Choose your client
💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Documentation Overview
Osama Hassouna · Docs
Source for docs.osamahassouna.com — an engineering reference hub I keep open while building. Currently one guide is live, with more landing as I write them.
Live now
HTML Email Playbook
A working reference for hand-building HTML email templates that render reliably across Outlook (Windows desktop, 2007 through 365), Gmail web + mobile, Apple Mail, Yahoo Mail, and the long tail of clients that haven't moved past 2007.
Covers:
- Structure — doctype, head boilerplate, body container, header / body / footer organization
- Components — bulletproof CTA buttons (with Outlook VML fallback), spacing patterns, images, inline icons, background images, text
- Compatibility — Outlook MSO conditional comments, RTL languages, hybrid responsive layouts
- Production — Gmail 102KB clipping, dark mode, preheader text
- AI Generation — rules and patterns for AI tools that generate playbook-compliant email HTML
Read it: docs.osamahassouna.com/email-playbook/
There's also a Playground at /email-playbook/playground/ with a live editor, instant preview, and a "From Image" tab that converts a design screenshot into playbook-compliant HTML.
Use the playbook in your AI workflow
The playbook is published as an MCP server + terminal CLI so AI clients (Claude Desktop, Cursor, Cline, etc.) can pull rules and component patterns directly into their reasoning. The model calls structured tools to fetch the exact patterns from the playbook instead of guessing from training data.
Setup, tool reference, and Claude Desktop / Cursor config snippets:
docs.osamahassouna.com/email-playbook/mcp/
There's also a hosted JSON-RPC endpoint at docs.osamahassouna.com/api/mcp if you'd rather not install anything.
License
MIT. Playbook content © Osama Hassouna · osamahassouna.com
Related MCP Servers
Frequently Asked Questions about HTML Email Playbook
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/html-email-playbook)HTML Embed
<a href="https://allmcps.com/mcp/html-email-playbook"><img src="https://allmcps.com/api/badge/html-email-playbook?style=directory" alt="HTML Email Playbook on AllMCPs" /></a>Technical Specs & Signals
CategoryCommunication
27Quality signal: Emerging · 27/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership8/20
Documentation & tools11/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge.
Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.