Camoufox Playwright MCP

An official-parity Playwright Model Context Protocol (MCP) server supercharged with Camoufox — the stealth, anti-detect browser engine designed to bypass anti-bot systems, Cloudflare Turnstile, DataDome, and advanced browser fingerprinting out of the box.

Highlights

• 🥷 Stealth by Default: Powered by Camoufox's custom anti-detect browser engine with hardware spoofing, humanized cursor movements, and GeoIP alignment.
• 🎭 100% Official Playwright MCP Parity: Full tool parity with the official TypeScript Playwright MCP (browser_navigate, browser_click, browser_fill, browser_snapshot, browser_take_screenshot, browser_evaluate, etc.).
• 🔄 Dual Engine Flexibility: Run with stealth camoufox by default, or seamlessly switch to standard Playwright browsers (chromium, chrome, firefox, webkit) or custom CDP endpoints.
• ⚡ Zero Install via uvx: Run instantly in Claude Desktop, Cursor, Cline, Windsurf, or any MCP client without manual setup.

Quickstart

1. Run On-The-Fly with uvx

No prior installation needed:

# Run stealth Camoufox browser in headless mode (recommended for AI agents)
uvx camoufox-playwright-mcp --headless

# Or run with standard Chrome
uvx camoufox-playwright-mcp --browser chrome

2. Client Configurations

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "camoufox": {
      "command": "uvx",
      "args": [
        "camoufox-playwright-mcp",
        "--headless"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "camoufox": {
      "command": "uvx",
      "args": ["camoufox-playwright-mcp", "--headless"]
    }
  }
}

Windsurf / Cline / OpenCode / Zed

{
  "mcpServers": {
    "browser": {
      "command": "uvx",
      "args": [
        "camoufox-playwright-mcp",
        "--headless"
      ]
    }
  }
}

Installation

You can also install camoufox-playwright-mcp into your virtual environment:

Using uv

uv add camoufox-playwright-mcp

Using pip

pip install camoufox-playwright-mcp

Installing Browser Binaries

Fetch the Camoufox browser binary:

camoufox-playwright-mcp install-browser

To install standard Playwright browsers as well:

camoufox-playwright-mcp install-browser chromium firefox webkit
# or install all
camoufox-playwright-mcp install-browser all

CLI Reference

usage: camoufox-playwright-mcp [-h] [--browser BROWSER] [--headless] [--isolated]
                               [--user-data-dir USER_DATA_DIR] [--proxy-server PROXY_SERVER]
                               [--cdp-endpoint CDP_ENDPOINT] [--port PORT] ...

Common Flags

Commands

• camoufox-playwright-mcp install-browser: Downloads Camoufox and/or Playwright browser binaries.

Camoufox Stealth & Anti-Detect Options

When running with --browser camoufox (default), Camoufox applies advanced stealth configurations. You can provide deeper configurations via a JSON config file (--config config.json):

{
  "browser": {
    "provider": "camoufox",
    "camoufoxOptions": {
      "geoip": true,
      "humanize": true,
      "os": "windows",
      "block_images": false
    }
  }
}

Environment Variables

All CLI flags can be configured via environment variables:

(Note: PLAYWRIGHT_MCP_* variables are also supported for backward compatibility).

Available MCP Tools

Full 1:1 match with official Playwright MCP specifications:

• browser_navigate: Navigate to a specified URL.
• browser_click: Click on elements using locators, coordinates, or text.
• browser_fill: Fill input fields with anti-detection keystrokes.
• browser_snapshot: Capture full accessibility and semantic tree snapshots.
• browser_take_screenshot: Capture full-page or element screenshots.
• browser_evaluate: Safely evaluate JavaScript within the page context.
• browser_hover, browser_press_key, browser_type: Mouse & keyboard interactions.
• browser_tabs: Manage multiple browser tabs and windows.
• browser_cookies: Get, set, and clear cookies.
• browser_network: Manage routes and network interception.

License

Apache License 2.0. See LICENSE for details.