MCP Directory

How to add Selenium MCP (mcp-selenium) to Claude Desktop

Selenium WebDriver MCP server — cross-browser automation for Chrome, Firefox, Edge, and Safari. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

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

Claude Desktop 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

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Selenium MCP (mcp-selenium) config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Selenium MCP (mcp-selenium)'s tools appear under the 🔌 tools menu.

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 Claude Desktop

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) + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_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 Claude Desktop?

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.

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