Interactive Demo

Watch Claude Code set up mails0 and walk through every core feature — from install to verification codes, semantic search, threading, live events, webhooks, MCP, and the Python SDK. Everything below is a scripted simulation of a real terminal session.

claude-code · boot
▸ scripted
Space play / pause · ← → jump chapter · R restart · hover a $ line to copy the command
▸ user — you talking to Claude Code ● claude — the agent's reply $ — shell command Claude runs output — program stdout (with ANSI color)

Try it for realnext steps

Everything in the tour is open source and runs on the Cloudflare free tier. Pick any of these to start.

1 · Install the CLI npm install -g mails-agent && mails claim <your-name>
2 · Open the browser playground mails0.com/playground/
3 · Hook up Claude Desktop / Cursor Read the MCP setup guide →
4 · Read the quickstart 2-minute walkthrough → or browse the source on GitHub →

All chapters

click any row to jump · Tab then Enter for keyboard

What this demo covers

Install & claim CH 1–2

Global npm install and a free mailbox backed by a mailbox-scoped API key (mk_ + 64 hex), in under 60 seconds.

quickstart.html →

Doctor check CH 3

One command verifies config, API connectivity, mailbox existence, and the Resend send path.

cli.html#doctor →

Send & inbox CH 4–5

Send via Resend, list inbound + outbound with the four auto-labels: personal / code / newsletter / notification.

messages.html →

Verification codes CH 6

Long-poll endpoint extracts 4–8 character codes across EN / 中文 / 日本語 / 한국어.

code-extraction.html →

Hybrid search CH 7

Keyword (FTS5) + semantic (Workers AI embeddings in Vectorize) fused with RRF.

search.html →

Threading CH 8

Auto-threaded conversations via In-Reply-To and References.

threading.html →

SSE events CH 9

Real-time stream — 5 event types (message.received / sent / delivered / bounced / complained). No public URL required.

events.html →

Webhooks CH 10

HMAC-SHA256 signed POSTs via X-Webhook-Signature; 4 retry attempts over ~15 seconds.

webhooks.html →

MCP server CH 11

10 tools for Claude Desktop, Cursor, Windsurf — agent calls email directly via native tool invocations.

mcp.html →

Python SDK CH 12

Sync MailsClient + async AsyncMailsClient, full type hints. Ideal for scripted signups.

python-sdk.html →

Next steps