HTML Email Playbook

email-playbook-mcp

AI モデルが壊れた HTML メールを生成するのを防ぎます。 この MCP サーバーと CLI は、HTML Email Playbook に基づき、Outlook 2007 以降、Gmail、Apple Mail で実際に正しく表示されるパターンを提供します。

これがないと、モデルは flex や grid（メールクライアントではサポートされていません）をでっち上げたり、モバイル画面からはみ出す表の幅をハードコードしたり、Outlook のボタンに必要な VML フォールバックを忘れたり、デザインにないフッターの免責事項を勝手に作ったりします。

これを使えば、モデルは構造化されたツールを呼び出してプレイブックから正確なパターンを取得し、学習データから推測するのではなく、それらを使ってメールを作成します。

🔒 メールの権限も、受信トレイへのアクセスも不要です。 これはナレッジ MCP であり、プレイブックのルールと HTML パターンを返します。メールを読んだり送信したりすることはなく、Gmail／Outlook／SMTP の認証情報を求めることもありません。受信トレイ連携型の MCP と混同されることがありますが、まったく別のカテゴリです。

インストール

# Global install (standard)
npm install -g email-playbook-mcp

# Or run on demand without installing
npx -y email-playbook-mcp@latest

安全にインストールできます

• 依存関係は 1 つ — 公式 MCP SDK（@modelcontextprotocol/sdk）のみです。
• postinstall スクリプトなし — インストール時に任意のコードは実行されません。
• 読み取り専用で、受信トレイにはアクセスしません — ツールはプレイブックの内容を返すだけです。メールの読み取り、送信、操作は一切行わず、受信トレイを開くことも、自らネットワーク通信を行うこともありません。

Claude Desktop で使用する

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "email-playbook": {
      "command": "email-playbook-mcp"
    }
  }
}

Claude Desktop を再起動します。モデルのツール一覧にプレイブックのツールが表示されます。メールの作成を依頼すると、モデルが自動的にツールを呼び出します。

裏側で行われること

画像からメールを作成する場合や、「ウェルカムメールを作って」というプロンプトの場合、モデルは通常、次のツールを呼び出します。

1. list_categories                                    ← orient, page slugs
2. get_playbook_rules({ format: "checklist" })        ← every page's rules, ~16 KB
3. get_rule({ slug: "compatibility/responsive" })     ← just the pages it needs
4. list_components → get_component({ name: "buttons" }) ← components it needs
5. compose final HTML using those exact patterns

このプロンプトを手動で書く必要はありません。モデルはツールの説明を通じて使い方を把握します。

Cursor で使用する

~/.cursor/mcp.json を編集します。

{
  "mcpServers": {
    "email-playbook": {
      "command": "email-playbook-mcp"
    }
  }
}

Cline／Continue／Windsurf など、MCP 対応のクライアントでも同じ形式を使います。command エントリーに email-playbook-mcp を指定してください。

CLI として使用する

同じパッケージには、クエリの直接実行やスクリプト作成に使える 2 つ目のバイナリも含まれています。

$ email-playbook get-component buttons | jq '{name, slots, requires_vml}'
{
  "name": "buttons",
  "slots": ["text", "url", "background_color", "text_color", "width_px", "height_px"],
  "requires_vml": true
}

ほかのコマンド：list-categories、list-components、get-rules [category] [--checklist]、get-rule <slug> [--examples]。get-rules／get-rule に --md を追加すると、JSON の代わりに読みやすい Markdown が表示されます。MCP のツール名はコマンド名としても使えます（get_playbook_rules、get_rule など）。ヘルプテキストは同梱の仕様から実行時に生成されるため、古くなることはありません。email-playbook --help を実行してください。

グローバルにインストールせずに実行する場合：

npx -y -p email-playbook-mcp email-playbook list-categories

ツール

ツール	戻り値
list_categories	4 つのルールカテゴリと、それぞれのページ数およびページスラッグ
get_playbook_rules({ category?, format? })	ルールページ：full（テキストとコード。デフォルト。1 つのカテゴリ）または checklist（従うべきルール。すべてのページを対象にする場合は category を省略。約 16 KB）
get_rule({ slug, include_examples? })	1 つのルールページとそのコード（compatibility/responsive または responsive）。include_examples: true を指定すると、コードが別の配列として追加されます
list_components	メタデータ付きの 6 つすべてのコンポーネント
get_component({ name })	1 つのコンポーネント：HTML パターン、スロット、VML／レスポンシブ対応フラグ

コンポーネントは別の軸にあります。get_playbook_rules ではなく、list_components／get_component を使用してください。

プレイブックの内容

項目	数	内容
structure（ルール）	5	Doctype、head、body コンテナー、ヘッダー、body、フッター
compatibility（ルール）	3	Outlook MSO、RTL 言語、レスポンシブ対応
production（ルール）	4	Gmail の 102KB クリップ、ダークモード、プリヘッダー、堅牢なボタン
ai-generation（ルール）	7	絶対的なルール、アセットポリシー、コンテンツの忠実性、画像のプレースホルダー、リンクトークン、出力形式、引き継ぎチェックリスト
コンポーネント	6	ボタン、間隔、画像、インラインアイコン、背景画像、テキスト

画像からメールを作成するタスクでは、まず ai-generation カテゴリーを取得してください。トレーニングデータから得た直感に優先するルールがまとめられています。https://example.com ではなく {{cta_url}} を使うこと、ソースに含まれている内容だけを再現すること、実際の URL が与えられていない画像にはすべて placehold.co の PNG ブロックを使うこと、HTML のみを返すことなどです。

対応していないこと

• メールは送信しません — ここで HTML を生成し、既存のプラットフォームから送信してください。
• プレビューはレンダリングしません — Playground でレンダリングできます（スクリーンショットがあれば、「From Image」タブを利用できます）。
• 既存の HTML は検証しません — 引き継ぎチェックリストを使って手動で確認してください。

ホスト型の代替手段

インストール不要です。任意の JSON-RPC 2.0 クライアントから https://docs.osamahassouna.com/api/mcp に接続してください。同じツール、同じコンテンツを認証なしで利用できます。

curl -X POST https://docs.osamahassouna.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

ライセンス

MIT © Osama Hassouna

• HTML Email Playbook
• インストールと設定のドキュメント
• ソース（mcp/ ディレクトリ）