MCP Directory

How to add MCP Server Playwright to Windsurf

Browser automation via Playwright — let LLMs navigate, click, fill forms, screenshot, and run JS in a real browser. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 295★ · stdio · no auth

Windsurf config for MCP Server Playwright

npx @automatalabs/mcp-server-playwright install
{
  "mcpServers": {
    "mcp-server-playwright": {
      "command": "npx",
      "args": [
        "-y",
        "@automatalabs/mcp-server-playwright"
      ]
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the MCP Server Playwright config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5MCP Server Playwright's tools become available to Cascade.

Before you start

  • Node.js with npx available in PATH
  • Playwright browsers installed (npx playwright install)
  • Windows or macOS (the automated installer checks OS compatibility)

What MCP Server Playwright can do in Windsurf

browser_navigate

Navigate to any URL in the browser.

browser_screenshot

Capture a screenshot of the entire page or a specific element. Accepts name (required), optional selector, and optional fullPage flag.

browser_click

Click an element on the page using a CSS selector.

browser_click_text

Click an element on the page by its text content.

browser_hover

Hover over an element on the page using a CSS selector.

browser_hover_text

Hover over an element on the page by its text content.

browser_fill

Fill out an input field given a selector and value.

browser_select

Select an option in a SELECT element using a CSS selector.

Security

Runs a real browser locally and executes arbitrary JavaScript supplied by the model via browser_evaluate, and navigates to any URL. Treat model-driven navigation and script execution as untrusted; avoid using on machines with sensitive logged-in browser sessions.

MCP Server Playwright + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the MCP Server Playwright config there under the "mcpServers" key and restart the client.

Is MCP Server Playwright safe to use with Windsurf?

Runs a real browser locally and executes arbitrary JavaScript supplied by the model via browser_evaluate, and navigates to any URL. Treat model-driven navigation and script execution as untrusted; avoid using on machines with sensitive logged-in browser sessions.

How do I install it?

Run `npx @automatalabs/mcp-server-playwright install`, which checks OS compatibility and creates/updates your Claude Desktop config. Alternatively install via Smithery: `npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client claude` (or `--client cursor`).

Can I use it with Cursor?

Yes. Install Playwright browsers with `npx playwright install`, then run the Smithery installer with `--client cursor`. If you do not use Claude, you may need to manually create claude_desktop_config.json as described in the README.

What resources does it expose?

Browser console logs at `console://logs` (text) and captured screenshots at `screenshot://<name>` (PNG, referenced by the name given during capture).

View repo Full MCP Server Playwright page