mobbin-mcp-better
v1.0.0
Published
MCP server for searching and browsing Mobbin design references — apps, screens, flows, and sites — with a local capture/artifact workflow for saving references into your project.
Maintainers
Readme
mobbin-mcp-better
An MCP (Model Context Protocol) server for searching and browsing Mobbin design references — apps, screens, flows, and sites — directly from Claude, Cursor, Codex, and other MCP-compatible clients. It also includes a local capture/artifact workflow for saving references into a project as durable, reusable context.
Install
npm install -g mobbin-mcp-betterRegister it with your MCP client, e.g. with Claude Code:
claude mcp add mobbin -- mobbin-mcp-betterAuthenticate
npx -y mobbin-mcp-better authThis opens a browser-based login flow and stores your session locally. Run mobbin_doctor (or mobbin-mcp-better --help) any time to check auth status.
Alternatively, set MOBBIN_AUTH_COOKIE directly:
- Open mobbin.com and log in
- DevTools → Application → Local Storage →
https://mobbin.com - Copy the value of the
sb-...-auth-tokenentry - Set
MOBBIN_AUTH_COOKIEto that value
Tools
Search & browse
mobbin_quick_search · mobbin_search_apps · mobbin_search_screens · mobbin_search_flows · mobbin_search_sites · mobbin_get_site_sections · mobbin_popular_apps · mobbin_get_filters · mobbin_get_screen_detail · mobbin_list_collections
Capture & artifacts — save references into your project for reuse across sessions
mobbin_capture_artifact · mobbin_capture_screen_from_search · mobbin_capture_flow_from_search · mobbin_capture_site_sections · mobbin_get_captured_artifact · mobbin_update_captured_artifact · mobbin_delete_captured_artifact · mobbin_search_captured_artifacts · mobbin_get_capture_catalog · mobbin_export_captured_artifacts · mobbin_import_captured_artifacts · mobbin_find_similar_artifacts · mobbin_sync_collections_to_artifacts · mobbin_sync_shared_store
Prompt & context generation — turn captured references into implementation-ready context
mobbin_generate_feature_prompt · mobbin_generate_agent_context · mobbin_generate_flow_contact_sheet · mobbin_generate_pr_reference · mobbin_generate_feature_review · mobbin_get_project_context
Diagnostics
mobbin_doctor — inspect auth, project detection, and artifact storage.
Platforms: ios, android, web, plus Mobbin's separate sites (marketing/landing-page) collection.
Environment variables
| Variable | Purpose |
|---|---|
| MOBBIN_AUTH_COOKIE | Manual auth cookie/session input |
| MOBBIN_AUTH_FILE | Override the stored session file path |
| MOBBIN_DATA_DIR | Override the data directory (default ~/.mobbin-mcp) |
| MOBBIN_BASE_URL | Override the Mobbin base URL |
| MOBBIN_PROJECT_ROOT | Override project detection for artifact storage |
| MOBBIN_CROSS_APP_SCAN_LIMIT | Tune how many apps a cross-app screen/flow search scans (default 12) |
Why this exists
Mobbin has no public API — this talks to the same internal endpoints Mobbin's own web app uses, kept working as Mobbin's backend evolves. If a tool starts erroring with an unexpected response shape, that usually means Mobbin changed something server-side; please open an issue with the error text.
License
MIT
Acknowledgments
Built on top of the original mobbin-mcp by aos-engineer — thanks for the original work that made this version possible.
