How to add Selenium MCP (mcp-selenium) to Windsurf

Selenium WebDriver MCP server — cross-browser automation for Chrome, Firefox, Edge, and Safari. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 900★ · stdio · no auth

Windsurf config for Selenium MCP (mcp-selenium)

npx -y @angiejones/mcp-selenium

{
  "mcpServers": {
    "selenium-mcp-mcp-selenium": {
      "command": "npx",
      "args": [
        "-y",
        "@angiejones/mcp-selenium"
      ]
    }
  }
}

Setup steps

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

Before you start

Node.js with npm (the server runs via npx or a global install)
A supported browser installed locally: Chrome, Firefox, Edge, or Safari
Matching WebDriver where needed (e.g. chromedriver). Safari requires macOS, a one-time `sudo safaridriver --enable`, and 'Allow Remote Automation' turned on; Safari has no headless mode
No API key or account — authentication is none

What Selenium MCP (mcp-selenium) can do in Windsurf

start_browser

Launch a browser session (Chrome, Firefox, Edge, or Safari).

navigate

Navigate the current session to a URL.

interact

Perform mouse actions: click, double-click, right-click, or hover on an element.

send_keys

Type text into an input element.

press_key

Press a keyboard key (e.g. Enter, Tab).

get_element_text

Read the text content of an element.

get_element_attribute

Read an attribute value from an element.

upload_file

Upload a file via a file input element.

Security

Requires a matching browser and WebDriver installed locally; the agent drives a real browser that can reach any site. Avoid pointing it at sites with sensitive logged-in sessions unless you intend the agent to act on them.

Selenium MCP (mcp-selenium) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Selenium MCP (mcp-selenium) config there under the "mcpServers" key and restart the client.

Is Selenium MCP (mcp-selenium) safe to use with Windsurf?

Does it need an API key?

No. It automates browsers installed locally on your machine, so there's no account, API key, or per-request cost — just Node.js and the browser/driver.

Which browsers are supported?

Chrome, Firefox, Edge, and Safari. Safari requires macOS, a one-time `sudo safaridriver --enable`, and 'Allow Remote Automation' enabled, and it cannot run headless.

How do I install it for Claude Code?

Run `claude mcp add selenium -- npx -y @angiejones/mcp-selenium@latest`. There's also a one-click Goose link and a global `npm install -g @angiejones/mcp-selenium` option.

View repo Full Selenium MCP (mcp-selenium) page