Email Playbook MCP
OsamaHassouna/docs-hub
Templates HTML de email production-ready com padrões comprovados para todos os clientes
Ver no GitHubHub de engenharia com guia de referência para construir templates HTML de email que renderizam corretamente em Outlook, Gmail, Apple Mail e outros clientes. Disponível como MCP server e CLI para integração com Claude, Cursor e outras ferramentas de IA.
Instalação
npx convez-ai OsamaHassouna/docs-hub1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar emails HTML compatíveis com Outlook e Gmail via IA
- Consultar padrões de componentes bulletproof (botões, spacing, imagens)
- Validar compatibilidade entre clientes de email antes de enviar
- Ensinar modelos de IA a escrever email estruturado e confiável
Veredito

Solução pragmática que resolve um problema real: fazer email HTML renderizar consistentemente. O MCP server eleva o valor ao integrar padrões testados diretamente no fluxo de IA, evitando alucinações sobre compatibilidade de clientes.
README
A tradução para o português deste README ainda está na fila.
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