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.
$ line to copy the command
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.
All chapters
click any row to jump · Tab then Enter for keyboardWhat this demo covers
Install & bootstrap CH 1–2
Global npm install and a random 72-hour receive-only mailbox, without browser approval or exposing the API key.
quickstart.html →Doctor check CH 3
One command verifies config, API connectivity, mailbox existence, expiry, and available capabilities.
cli.html#doctor →Upgrade, send & inbox CH 4–5
Use human-approved claim before outbound email, then list inbound + outbound with automatic labels.
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 →SSE events CH 9
Real-time stream — 5 event types (message.received / sent / delivered / bounced / complained). No public URL required.
Webhooks CH 10
HMAC-SHA256 signed POSTs via X-Webhook-Signature; 4 retry attempts over ~15 seconds.
MCP server CH 11
11 tools for Claude Desktop, Cursor, and Windsurf, including safe zero-config mailbox creation.
mcp.html →Python SDK CH 12
Sync MailsClient + async AsyncMailsClient, full type hints. Ideal for scripted signups.
Next steps
- Run it for real:
npm install -g mails-agent && mails bootstrap - Drop the MCP config into Claude Desktop — see mcp.html
- Self-host on Cloudflare: self-hosting guide