# htmlbook

> htmlbook is a hosting library — a "bookshelf" — for HTML documents written by AI coding agents. An agent (Claude Code, Cursor, Codex, or claude.ai) writes an HTML report, dashboard, or spec and pushes it to htmlbook over the Model Context Protocol (MCP) or a REST API; htmlbook stores it, re-themes it for comfortable reading on any device, organizes it by project, and gives every document a short public share link. Documents arrive by agent push or by uploading a finished .md/.html file into the library — there is no web authoring form — but the owner can tap any text in the reader to fix it in place; each save becomes a new version.

htmlbook exists for the workflow where an AI agent generates HTML and you need it off your laptop: readable on your phone, shareable with a link, and kept in one place instead of buried in a project folder or lost with the chat log.

Key facts:

- Write path: an agent pushes an `hb-doc` HTML document to the remote MCP server at https://htmlbook.io/api/mcp, or via `POST https://htmlbook.io/api/docs` with an API key; signed-in owners can also upload .md/.html files directly in the library. Documents cannot be authored from scratch on the website.
- Supported clients: Claude Code, Cursor, and Codex (static API key over MCP or REST); claude.ai and Claude Desktop (OAuth).
- Reading: a document carries no CSS of its own, so the reader re-themes it (paper / sepia / dark) and adjusts width and font size. A standalone page that ships its own CSS/JS is stored verbatim and rendered in a sandbox.
- Editing: the owner can tap any text block in the reader to edit it in place; saving creates a new immutable version (previous versions stay restorable). Works for every document kind — themeable hb-docs are re-sanitized like an agent push, and standalone pages are edited via precise text patches against their stored source, preserving their own scripts, styles, and formatting (only script-generated runtime text is not editable).
- Sharing: every document has one short link, https://htmlbook.io/d/{shortId}, with two modes — public (anyone can read it, no login) or secret (private; only the owner and workspace members can open it, after signing in).
- Privacy: every document is private by default — anonymous readers can open it only after the owner flips it public, and flipping it back removes the public copy (the link reverts to members-only). Access is authorized server-side on every request, data is encrypted in transit and at rest, API keys are stored only as SHA-256 hashes, documents can be permanently deleted, and they are never used to train models or sold.
- Organization: documents group into projects and workspaces, and every version is kept — the reader's History panel shows who changed what (agent push vs web edit, with precise before/after text) and can restore any version.
- Teams: a workspace owner shares an invite link; members join as editors who read everything in the workspace and fix text in the reader, with each edit versioned under their name.
- Pricing: free to start; signing up provisions a library and a personal workspace, and you generate an API key in Settings.

## Core pages

- [Home](https://htmlbook.io/): What htmlbook is and how the agent → shelf → share flow works.
- [Connect your agent (MCP & API)](https://htmlbook.io/mcp): Step-by-step connection for Claude Code, Cursor, and Codex (MCP server or API key) and for claude.ai / Claude Desktop (OAuth).
- [Full text for LLMs](https://htmlbook.io/llms-full.txt): The complete, self-contained description of htmlbook — concepts, MCP tools, the hb-doc contract, and FAQ.

## Optional

- [Discord community](https://discord.gg/hqMkDFPR): Questions and support.