Mobbin MCP Server

An unofficial MCP server that connects to Mobbin — the design inspiration platform with 600k+ screens from 1,100+ apps. Search apps, browse screenshots, explore user flows, and access your saved collections directly from Claude.

Mobbin has no public API. This server was built by reverse-engineering their internal endpoints.

Tools

Drilling into a specific app

mobbin_search_screens and mobbin_search_flows index Mobbin globally — they don't accept an app_id filter (the upstream API ignores per-app filters silently). For "show me Notion's onboarding"-style queries, use the two-step path: mobbin_quick_search to look up the app's id, then mobbin_get_app_screens or mobbin_get_app_flows with that app_id. The detail tools read from Mobbin's SSR'd app-detail page, so they return everything Mobbin has for that app.

Migration: mobbin_get_filters

The no-arg form was removed. The full taxonomy in one response exceeded the MCP per-tool-result token cap and forced the agent to read the result back from a temp file. Pass a kind to scope the response to one facet:

mobbin_get_filters({ kind: "patterns" })                               // newline list of names
mobbin_get_filters({ kind: "patterns", include_definitions: true })    // bullets with descriptions
mobbin_get_filters({ kind: "patterns", include_counts: true })         // bullets with content counts

Setup

Prerequisites

• Node.js 18+

• A Mobbin account (free or paid)

1. Authenticate

Option A: CLI command (recommended)

npx -y mobbin-mcp@latest auth

This will walk you through copying your session cookie from the browser:

1. Open mobbin.com and log in

2. Open the browser console (Cmd+Option+J)

3. Run copy(document.cookie) to copy your cookies to clipboard

4. Paste into the CLI prompt

Your session is saved to ~/.mobbin-mcp/auth.json and automatically refreshed.

What does copy(document.cookie) do? It copies your browser's cookies for the current site (mobbin.com) to your clipboard. This includes your Supabase session tokens, which the MCP server needs to make API requests on your behalf. The cookies are stored locally on your machine at ~/.mobbin-mcp/auth.json and are never sent anywhere except to Mobbin's API.

Option B: Environment variable (manual)

1. Open mobbin.com in Chrome and log in

2. Open DevTools (Cmd+Option+I) → Application tab → Cookies → https://mobbin.com

3. Find the cookies named sb-ujasntkfphywizsdaapi-auth-token.0 and sb-ujasntkfphywizsdaapi-auth-token.1

4. Copy the full value of each cookie

5. Combine them into a single string:

sb-ujasntkfphywizsdaapi-auth-token.0=<value0>; sb-ujasntkfphywizsdaapi-auth-token.1=<value1>

6. Set MOBBIN_AUTH_COOKIE to that value (see step 2 below)

2. Add to Claude Code

claude mcp add mobbin -- npx -y mobbin-mcp

If you used the CLI auth command (Option A), no additional config is needed — the server reads from ~/.mobbin-mcp/auth.json automatically.

If using the environment variable (Option B), pass it when adding:

claude mcp add mobbin -e MOBBIN_AUTH_COOKIE="sb-ujasntkfphywizsdaapi-auth-token.0=...; sb-ujasntkfphywizsdaapi-auth-token.1=..." -- npx -y mobbin-mcp

Alternative: Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mobbin": {
      "command": "npx",
      "args": ["-y", "mobbin-mcp"]
    }
  }
}

Example prompts

• "I'm designing a checkout flow for a food delivery app — show me how top apps like DoorDash and Uber Eats handle it"

• "Pull up the Duolingo onboarding flow and walk me through each screen's design decisions"

• "Find login screens that use bottom sheets and extract the color palette — I need inspiration for our auth redesign"

• "Compare how fintech apps handle settings screens — show me examples from Robinhood, Cash App, and Venmo"

• "Search for screens with card-based layouts in travel apps, then show me the best one in detail"

• "What UI patterns are trending right now on iOS? Show me the top screens"

How it works

Mobbin is a Next.js app backed by Supabase. This server calls Mobbin's internal API routes (/api/content/search-apps, /api/content/search-screens, etc.) using your session cookie for authentication. Tokens are automatically refreshed via Supabase's /auth/v1/token endpoint before they expire, and persisted back to ~/.mobbin-mcp/auth.json when using the CLI auth method.

Screen images are served through Mobbin's Bytescale CDN. The mobbin_get_screen_detail tool automatically converts Supabase storage URLs from search results into CDN URLs, fetches the image, and returns it as base64 content that the model can see and analyze. Optional color extraction uses sharp to return dominant hex colors from the screenshot.

Project structure

src/
  index.ts              # MCP server entry point, CLI routing, and tool registration
  constants.ts          # API URLs, keys, and config
  types.ts              # TypeScript interfaces for all Mobbin data models
  cli/
    auth.ts             # Interactive CLI authentication flow
  services/
    auth.ts             # Token parsing, expiry checks, and auto-refresh
    api-client.ts       # HTTP client for all Mobbin API endpoints
  utils/
    auth-store.ts       # Persistent session storage (~/.mobbin-mcp/auth.json)
    formatting.ts       # Markdown formatters for tool responses

License

ISC