Browser automation using Playwright with optional stealth mode to bypass anti-bot protection.
To add playwright-stealth to Claude, run the install command below or copy the ready-made config for Claude Code, Claude Desktop, Cursor and VS Code further down. Restart your client after adding it and its tools show up in your next conversation. It needs 15 environment variables, listed below.
Install
npx -y playwright-stealth-mcp-server@0.2.3Environment variables
STEALTH_MODESet in your MCP configSTEALTH_USER_AGENTSet in your MCP configSTEALTH_MASK_LINUXSet in your MCP configSTEALTH_LOCALESet in your MCP configHEADLESSSet in your MCP configTIMEOUTSet in your MCP configNAVIGATION_TIMEOUTSet in your MCP configSCREENSHOT_STORAGE_PATHSet in your MCP configVIDEO_STORAGE_PATHSet in your MCP configPROXY_URLSet in your MCP configPROXY_USERNAMESet in your MCP configPROXY_PASSWORDSet in your MCP configPROXY_BYPASSSet in your MCP configBROWSER_PERMISSIONSSet in your MCP configIGNORE_HTTPS_ERRORSSet in your MCP configInstall with your client
claude mcp add playwright-stealth --env STEALTH_MODE=<YOUR_STEALTH_MODE> --env STEALTH_USER_AGENT=<YOUR_STEALTH_USER_AGENT> --env STEALTH_MASK_LINUX=<YOUR_STEALTH_MASK_LINUX> --env STEALTH_LOCALE=<YOUR_STEALTH_LOCALE> --env HEADLESS=<YOUR_HEADLESS> --env TIMEOUT=<YOUR_TIMEOUT> --env NAVIGATION_TIMEOUT=<YOUR_NAVIGATION_TIMEOUT> --env SCREENSHOT_STORAGE_PATH=<YOUR_SCREENSHOT_STORAGE_PATH> --env VIDEO_STORAGE_PATH=<YOUR_VIDEO_STORAGE_PATH> --env PROXY_URL=<YOUR_PROXY_URL> --env PROXY_USERNAME=<YOUR_PROXY_USERNAME> --env PROXY_PASSWORD=<YOUR_PROXY_PASSWORD> --env PROXY_BYPASS=<YOUR_PROXY_BYPASS> --env BROWSER_PERMISSIONS=<YOUR_BROWSER_PERMISSIONS> --env IGNORE_HTTPS_ERRORS=<YOUR_IGNORE_HTTPS_ERRORS> -- npx -y playwright-stealth-mcp-server@0.2.3
Run this in a terminal to add the server to Claude Code.
What this does
playwright-stealth exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.
Requirements
This server needs the following environment variables to be set before it can run:
STEALTH_MODE STEALTH_USER_AGENT STEALTH_MASK_LINUX STEALTH_LOCALE HEADLESS TIMEOUT NAVIGATION_TIMEOUT SCREENSHOT_STORAGE_PATH VIDEO_STORAGE_PATH PROXY_URL PROXY_USERNAME PROXY_PASSWORD PROXY_BYPASS BROWSER_PERMISSIONS IGNORE_HTTPS_ERRORS
Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).
Frequently asked questions
How do I install playwright-stealth?
Run the Claude Code command in the install section to add playwright-stealth to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.
Which clients work with playwright-stealth?
This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to playwright-stealth as well.
Does playwright-stealth need an API key?
Yes. Before it can run, set these environment variables: STEALTH_MODE, STEALTH_USER_AGENT, STEALTH_MASK_LINUX, STEALTH_LOCALE, HEADLESS, TIMEOUT, NAVIGATION_TIMEOUT, SCREENSHOT_STORAGE_PATH, VIDEO_STORAGE_PATH, PROXY_URL, PROXY_USERNAME, PROXY_PASSWORD, PROXY_BYPASS, BROWSER_PERMISSIONS, IGNORE_HTTPS_ERRORS. They go in the env block of your MCP config.
Imported from the Official MCP Registry. The details above come from the registry entry; the maker can claim this listing to correct them, add docs, and see its traffic.
Is this your MCP server?
Claim this listing to see its traffic, fix details yourself, and skip the review queue on future updates.
Add this badge to your README
Show visitors this server is listed in the ClaudeRules directory. The badge links straight to this listing.
[](https://clauderules.net/mcp/com-pulsemcp-playwright-stealth)<a href="https://clauderules.net/mcp/com-pulsemcp-playwright-stealth" target="_blank" rel="noopener noreferrer"><img src="https://clauderules.net/api/badge/com-pulsemcp-playwright-stealth" alt="Listed on clauderules.net" /></a>More Browser MCP servers
microsoft/playwright-mcp
Official Microsoft Playwright MCP server, enabling LLMs to interact with web pages through structured accessibility snapshots
agent-infra/mcp-server-browser
📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
browsermcp/mcp
📇 🏠 - Automate your local Chrome browser
executeautomation/playwright-mcp-server
📇 - An MCP server using Playwright for browser automation and webscrapping
