Phonebook
Turns SwiftUI #Preview and Jetpack Compose @Preview screens into a static HTML gallery
- Pricing
- Open source
- Platforms
- CLI, self-hosted, iOS
- Runs
- Locally
- Version
- 0.1.13
- Listing updated
- 2 days ago
About Phonebook
Phonebook is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Phonebook is pitched as a self-hosted, open-source alternative to Emerge Tools Snapshots. Instead of writing new test code, it harvests the previews your team already has and renders them into a Storybook-style gallery that designers can open without installing anything. Cards are grouped as component and state, inferred from preview names with no extra annotation.
The flow has two steps. phonebook generate runs the platform's preview renderer and writes a bundle with a manifest.json and images; on Android it uses Roborazzi and ComposablePreviewScanner on the JVM with no emulator, and on iOS it uses SnapshotPreviews through xcodebuild on a simulator, which needs macOS. phonebook build then makes plain HTML, CSS and JS that works from file:// or any static host. Each repo runs independently and, in version one, handles a single platform.
The MCP server is the recommended way in: a coding agent can check setup, analyse preview coverage, add missing previews and build the gallery. Init and doctor commands resolve library versions against the project's Kotlin version to catch metadata mismatches early.
Install
Run in a terminal
claude mcp add phonebook -- npx -y @stag-build/phonebookAdd to claude_desktop_config.json
{
"mcpServers": {
"phonebook": {
"command": "npx",
"args": [
"-y",
"@stag-build/phonebook"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"phonebook": {
"command": "npx",
"args": [
"-y",
"@stag-build/phonebook"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"phonebook": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@stag-build/phonebook"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"phonebook": {
"command": "npx",
"args": [
"-y",
"@stag-build/phonebook"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"phonebook": {
"command": "npx",
"args": [
"-y",
"@stag-build/phonebook"
]
}
}
}What it does
- Reuses existing previews
- Harvests @Preview and #Preview code with no new test code.
- Static HTML gallery
- Output works from file:// or any static host, with no SaaS account.
- Agent-driven setup
- The MCP server lets an agent check setup, find missing previews and build the site.
- Component and state cards
- Groups previews by names without needing annotations.
- Android on the JVM
- Roborazzi and Robolectric render previews without an emulator.
- Version-aware init
- init and doctor align library versions with the project's Kotlin version.
Good for
- Publish a component gallery for designers from an Android repo
- Review iOS SwiftUI preview states without opening Xcode
- Find components that lack previews
- Generate the gallery in CI
- Let a coding agent set up preview rendering
Pricing
Open source
Free, open source, self-hosted
Prices change. Check stag-build.github.io before you buy.
Phonebook FAQ
Do I need a SaaS account?
No. It is self-hosted and runs locally or in your CI.
Can one repo cover both platforms?
Not in v1; one Android or iOS repo produces one bundle and one site.
What does iOS need?
macOS, since previews render with xcodebuild on a simulator.
How do I start the MCP server?
Run npx -y @stag-build/phonebook mcp, for example via claude mcp add phonebook.
How can I install the CLI?
npm install -g @stag-build/phonebook or Homebrew.
Is Phonebook free?
Yes. Phonebook is open source, so you can use and self-host it for free.
How do I add Phonebook to Claude Code?
Run this command in your terminal: claude mcp add phonebook -- npx -y @stag-build/phonebook
What are the best alternatives to Phonebook?
The closest alternatives to Phonebook are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to Phonebook

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory