Mobbin MCP Server

An 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 using Playwright.

Tools

Setup

Prerequisites

• Node.js 18+

• A Mobbin account (free or paid)

1. Clone and install

git clone https://github.com/pdcolandrea/mobbin-mcp.git
cd mobbin-mcp
npm install

2. Get your auth cookie

The server authenticates using your Mobbin session cookie. To extract it:

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 in this format:

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

The server automatically refreshes expired tokens using Supabase's auth API, so you generally only need to do this once per session.

3. Add to Claude Code

Run this from your terminal:

claude mcp add mobbin -- npx tsx /path/to/mobbin-mcp/src/index.ts

Then set the environment variable. Add to your ~/.claude/settings.json under the mobbin server entry:

{
  "mcpServers": {
    "mobbin": {
      "command": "npx",
      "args": ["tsx", "/path/to/mobbin-mcp/src/index.ts"],
      "env": {
        "MOBBIN_AUTH_COOKIE": "sb-ujasntkfphywizsdaapi-auth-token.0=...; sb-ujasntkfphywizsdaapi-auth-token.1=..."
      }
    }
  }
}

Alternative: Claude Desktop

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

{
  "mcpServers": {
    "mobbin": {
      "command": "npx",
      "args": ["tsx", "/path/to/mobbin-mcp/src/index.ts"],
      "env": {
        "MOBBIN_AUTH_COOKIE": "sb-ujasntkfphywizsdaapi-auth-token.0=...; sb-ujasntkfphywizsdaapi-auth-token.1=..."
      }
    }
  }
}

Example prompts

• "Search Mobbin for fintech apps on iOS"

• "Find login screen designs across e-commerce apps"

• "Show me onboarding flows for AI apps"

• "What are the most popular apps on Mobbin right now?"

• "Search for screens with a Card UI element in finance apps"

• "List my saved collections"

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.

Project structure

src/
  index.ts              # MCP server entry point and tool registration
  constants.ts          # API URLs, keys, and config
  types.ts              # TypeScript interfaces for all Mobbin data models
  services/
    auth.ts             # Token parsing, expiry checks, and auto-refresh
    api-client.ts       # HTTP client for all Mobbin API endpoints
  utils/
    formatting.ts       # Markdown formatters for tool responses

License

ISC