angiejones/mcp-selenium

A Model Context Protocol (MCP) server for Selenium WebDriver — browser automation for AI agents.
## Setup
Goose (Desktop)
Paste into your browser address bar:
goose://extension?cmd=npx&arg=-y&arg=%40angiejones%2Fmcp-selenium%40latest&id=selenium-mcp&name=Selenium%20MCP&description=automates%20browser%20interactions
Goose (CLI)
bash
goose session --with-extension "npx -y @angiejones/mcp-selenium@latest"
Claude Code
bash
claude mcp add selenium -- npx -y @angiejones/mcp-selenium@latest
Cursor / Windsurf / other MCP clients
json
"mcpServers": {
"selenium": {
"command": "npx",
"args": ["-y", "@angiejones/mcp-selenium@latest"]
## Example Usage
Tell the AI agent of your choice:
> Open Chrome, go to github.com/angiejones, and take a screenshot.
The agent will call Selenium's APIs to start_browser, navigate, and take_screenshot. No manual scripting or explicit directions needed.
## Supported Browsers
Chrome, Firefox, Edge, and Safari.
> Safari note: Requires macOS. Run sudo safaridriver --enable once and enable
> "Allow Remote Automation" in Safari → Settings → Developer. No headless mode.
Tools
### start_browser
Launches a browser session.
| Parameter | Type | Required | Description |
| browser | string | Yes | chrome, firefox, edge, or safari |
| options | object | No | { headless: boolean, arguments: string[] } |
### navigate
Navigates to a URL.
| Parameter | Type | Required | Description |
| url | string | Yes | URL to navigate to |
### interact
Performs a mouse action on an element.
| Parameter | Type | Required | Description |
| action | string | Yes | click, doubleclick, rightclick, or hover |
| by | string | Yes | Locator strategy: id, css, xpath, name, tag, class |
| value | string | Yes | Value for the locator strategy |
| timeout | number | No | Max wait in ms (default: 10000) |
### send_keys
Types text into an element. Clears the field first.
| Parameter | Type | Required | Description |
| by | string | Yes | Locator strategy |
| value | string | Yes | Locator value |
| text | string | Yes | Text to enter |
| timeout | number | No | Max wait in ms (default: 10000) |
### get_element_text
Gets the text content of an element.
| Parameter | Type | Required | Description |
| by | string | Yes | Locator strategy |
| value | string | Yes | Locator value |
| timeout | number | No | Max wait in ms (default: 10000) |
### get_element_attribute
Gets an attribute value from an element.
| Parameter | Type | Required | Description |
| by | string | Yes | Locator strategy |
| value | string | Yes | Locator value |
| attribute | string | Yes | Attribute name (e.g., href, value, class) |
| timeout | number | No | Max wait in ms (default: 10000) |
### press_key
Presses a keyboard key.
| Parameter | Type | Required | Description |
| key | string | Yes | Key to press (e.g., Enter, Tab, a) |
### upload_file
Uploads a file via a file input element.
| Parameter | Type | Required | Description |
| by | string | Yes | Locator strategy |
| value | string | Yes | Locator value |
| filePath | string | Yes | Absolute path to the file |
| timeout | number | No | Max wait in ms (default: 10000) |
### take_screenshot
Captures a screenshot of the current page.
| Parameter | Type | Required | Description |