Selenium MCP Server

An MCP server that uses Selenium to interact with a WebDriver instance.

Local serverstdioTypeScript

What is the Selenium MCP server?

If you want an AI assistant working directly with Selenium, the selenium mcp server is the bridge. An MCP server that uses Selenium to interact with a WebDriver instance.

What Selenium does

An MCP server that uses Selenium to interact with a WebDriver instance. Built using the MCP-Server-Starter template.

This server allows AI agents to control a web browser session via Selenium WebDriver, enabling tasks like web scraping, automated testing, and form filling through the Model Context Protocol.

Tools it exposes

Once connected, the assistant can call these 6 tools directly:

  • selenium_navigate — Navigates the browser to a specific URL
  • selenium_findElement — Finds an element on the page using a CSS selector
  • selenium_click — Clicks an element
  • selenium_sendKeys — Sends keystrokes to an element
  • selenium_getPageSource — Retrieves the current page source HTML
  • Debugging — Use the MCP Inspector or standard Node.js debugging techniques

Installing the selenium mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Requirements

  • Node.js (v18 or later) * npm (v7 or later) * A WebDriver executable (e.g., ChromeDriver, GeckoDriver) installed and available in your system's PATH. * A compatible web browser (e.g., Chrome, Firefox).

Where it fits

Browser automation servers are the ones people reach for when a site has no API — the assistant drives a real page instead of guessing at endpoints. Selenium sits in that group, and the shape of its toolset — selenium_navigate, selenium_findElement, selenium_click among others — tells you what it is really for. Worth comparing against the other browser automation servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • Maintained by themindmod, written in TypeScript.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the selenium mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
selenium_navigateNavigates the browser to a specific URL.
selenium_findElementFinds an element on the page using a CSS selector.
selenium_clickClicks an element.
selenium_sendKeysSends keystrokes to an element.
selenium_getPageSourceRetrieves the current page source HTML.
DebuggingUse the MCP Inspector or standard Node.js debugging techniques.

Configuration

  • Node.js (v18 or later) * npm (v7 or later) * A WebDriver executable (e.g., ChromeDriver, GeckoDriver) installed and available in your system's PATH. * A compatible web browser (e.g., Chrome, Firefox).

Example prompts to try

  • Use Selenium to selenium navigate.
  • Use Selenium to selenium findElement.
  • Use Selenium to selenium click.

Frequently asked questions

It connects Selenium to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (selenium_navigate, selenium_findElement, selenium_click, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Selenium directly.