English Français العربية

HTML Email Playbook

Registre officiel Productivité

Teaches AI to write HTML email that renders in Outlook, Gmail, and Apple Mail. 19 rules, 6 comps.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http html-email-playbook 'https://docs.osamahassouna.com/api/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "html-email-playbook": {
            "type": "http",
            "url": "https://docs.osamahassouna.com/api/mcp"
        }
    }
}
NPM package email-playbook-mcp
Claude Code 
claude mcp add html-email-playbook -- npx -y email-playbook-mcp@0.7.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "html-email-playbook": {
            "command": "npx",
            "args": [
                "-y",
                "email-playbook-mcp@0.7.0"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Osama Hassouna · Docs
  2. Live now
  3. Use the playbook in your AI workflow
  4. License

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.

npm install -g email-playbook-mcp

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

Questions fréquentes

Qu'est-ce que HTML Email Playbook ?

Teaches AI to write HTML email that renders in Outlook, Gmail, and Apple Mail. 19 rules, 6 comps.

Comment installer HTML Email Playbook ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http html-email-playbook 'https://docs.osamahassouna.com/api/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour HTML Email Playbook ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

HTML Email Playbook est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient HTML Email Playbook ?

Il est publié par OsamaHassouna. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.