Osama Hassouna · Docs

MCP serverCommunication

Your AI can write HTML email that renders in Outlook, Gmail, and Apple Mail. This integration provides 19 rules and 6 comps that guide how the email is written. Once added, the emails your AI produces will display correctly across these mail apps.

Use Osama Hassouna · Docs in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Osama Hassouna · Docs and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use Osama Hassouna · Docs to list categories

Details

Available today. Use it from your connected AI after setup.

After adding it, ask your AI to draft an HTML email. It will apply the 19 rules and 6 comps as it writes.

Osama Hassouna · DocsStart free

What your AI can do with it

  • Write HTML email that renders in Outlook, Gmail, and Apple Mail
  • Follow 19 rules for email that renders correctly
  • Use 6 comps as references while writing
  • Turn your content into HTML email

Install Osama Hassouna · Docs

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user osama-hassouna-docs 'https://docs.osamahassouna.com/api/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://docs.osamahassouna.com/api/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=osama-hassouna-docs&config=eyJ1cmwiOiJodHRwczovL2RvY3Mub3NhbWFoYXNzb3VuYS5jb20vYXBpL21jcCJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://docs.osamahassouna.com/api/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add osama-hassouna-docs --url 'https://docs.osamahassouna.com/api/mcp'

    Run it once, then sign in with codex mcp login osama-hassouna-docs if the server asks for an account.

From the project's README

As published by osamahassouna/docs-hub in README.md.

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

Tools it offers (4)

What this server listed when Ahel dialed its public endpoint in Oct 2026, with no key and no account of yours. The names are the server’s own.

  • list_categories
  • get_playbook_rules
  • list_components
  • get_component

Signals

Last commit
Sep 2026
Weekly downloads
44
Weekly_downloads
44 weekly_downloads
Advanced
Delivery
email-playbook-mcp MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-osamahassouna-email-playbook-mcp
Source
github.com/osamahassouna/docs-hub
Hosted endpoint
https://docs.osamahassouna.com/api/mcp