Playwright MCP server in Claude Desktop.
Edit claude_desktop_config.json once and Claude can browse for you — open pages, fill forms, and read what's on screen through Microsoft's playwright-mcp.
Claude Desktop can't see the web on its own — playwright-mcp fixes that by handing it a controllable browser. Microsoft's server (33.7k stars on GitHub) exposes navigation, clicking, form filling, and page snapshots as MCP tools, and it reads pages through the accessibility tree, so Claude works with structured content instead of guessing at pixels.
Setup is a single JSON edit. The only Claude Desktop quirk worth knowing in advance: config changes require a full quit, not just closing the window.
Find the config file
Claude Desktop reads MCP servers from claude_desktop_config.json. On macOS it lives at ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows it's %APPDATA%\Claude\claude_desktop_config.json. The fastest way to get there is Settings > Developer > Edit Config, which opens the file (and creates it if it doesn't exist yet).
You also need Node.js installed, because Claude Desktop will launch the server with npx. If node --version fails in a terminal, install Node 18 or newer first.
Add the mcpServers entry
Add playwright under the mcpServers key. If the file already has other servers, add this as a sibling entry — don't create a second mcpServers object.
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}Restart fully, then test
Quit Claude Desktop completely — on macOS that's Cmd+Q, on Windows quit from the system tray icon. Closing the window leaves the process running with the old config. On relaunch, the tools icon in the chat input should show the playwright server with tools like browser_navigate and browser_snapshot.
Try "go to example.com and describe the page." A Chromium window will open and Claude will narrate what it finds. Since Claude Desktop is an interactive app, the default headed browser is actually pleasant here — you can watch every click. Add "--headless" to the args array if you'd rather it stay invisible.
Troubleshooting in Claude Desktop
Server never appears: it's the JSON or the restart. Validate claude_desktop_config.json (one stray comma is enough to make the app ignore it) and confirm you fully quit rather than closed the window.
Appears, then errors: check the MCP logs. Claude Desktop writes per-server logs to ~/Library/Logs/Claude/ on macOS (look for mcp-server-playwright.log) and %APPDATA%\Claude\logs on Windows. An ENOENT on npx means the app can't find Node — GUI apps on macOS don't inherit your shell PATH, so either install Node system-wide or set command to the absolute path of npx.
Browser fails to launch: run npx playwright install chromium in a terminal once to fetch the browser binary, then restart the app.
On the Loomal index
The server's live listing, including its full probed tool list, is at https://loomal.ai/marketplace/playwright-mcp in the Browser Automation category. Loomal indexes MCP servers in a machine-queryable form, so the same listing a human reads here is one an agent can discover programmatically — and, for claimed servers with hosted endpoints, pay per call over x402.
FAQ
How do I install Playwright MCP in Claude Desktop?
Open Settings > Developer > Edit Config to get to claude_desktop_config.json, add a playwright entry under mcpServers with command npx and args ["@playwright/mcp@latest"], then fully quit and relaunch Claude Desktop. The browser tools appear under the tools icon in the chat input.
Where is claude_desktop_config.json?
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. Windows: %APPDATA%\Claude\claude_desktop_config.json. If the file doesn't exist, the Edit Config button in Settings > Developer creates it for you with an empty mcpServers object.
I edited the config but nothing changed — why?
Claude Desktop only reads the config at startup, and closing the window doesn't stop the app. Quit it completely (Cmd+Q on macOS, quit from the tray on Windows) and reopen. If it still doesn't load, run the file through a JSON validator — syntax errors fail silently.
Where do I look when the server crashes?
Claude Desktop keeps per-server MCP logs: ~/Library/Logs/Claude/mcp-server-playwright.log on macOS, %APPDATA%\Claude\logs on Windows. The most common entries are npx not found (Node missing from the app's PATH) and Playwright's browser-not-installed error, fixed with npx playwright install chromium.
Browse more MCP servers for Claude Desktop.
Search the Loomal index by category, package, and pricing.