# Browser Automation

This MCP server lets an agent navigate websites, interact with page elements, fill forms, and capture screenshots. Use it for browser tasks where you want to see or resume the session.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Author: mindstone
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mindstone/mcp-servers/tree/HEAD/connectors/browser-automation
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/browser-automation

## What it does

An agent can open URLs, inspect page text and titles, interact with form fields, switch tabs, take screenshots, and save a page as a PDF. It can target elements through accessibility references or CSS selectors. Browser sessions can persist for later use.

The server needs Node.js 20+, npm, and the `agent-browser` CLI on `PATH`; it can also launch the CLI through `npx`. No API key or credentials are needed to connect. The browser window is visible by default, and `MCP_WORKSPACE_PATH` sets the directory used for PDFs and uploaded files. Without `agent-browser` on `PATH` or an available `npx`, the server cannot control a browser.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `AGENT_BROWSER_SESSION_NAME`, `AGENT_BROWSER_SHOW_WINDOW`, `MCP_WORKSPACE_PATH` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env AGENT_BROWSER_SESSION_NAME=<AGENT_BROWSER_SESSION_NAME> --env AGENT_BROWSER_SHOW_WINDOW=<AGENT_BROWSER_SHOW_WINDOW> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --transport stdio browser-automation -- npx -y @mindstone/mcp-server-browser-automation
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add browser-automation --env AGENT_BROWSER_SESSION_NAME=<AGENT_BROWSER_SESSION_NAME> --env AGENT_BROWSER_SHOW_WINDOW=<AGENT_BROWSER_SHOW_WINDOW> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> -- npx -y @mindstone/mcp-server-browser-automation
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "browser-automation": {
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-browser-automation"
            ],
            "env": {
                "AGENT_BROWSER_SESSION_NAME": "<AGENT_BROWSER_SESSION_NAME>",
                "AGENT_BROWSER_SHOW_WINDOW": "<AGENT_BROWSER_SHOW_WINDOW>",
                "MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "browser-automation": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-browser-automation"
            ],
            "env": {
                "AGENT_BROWSER_SESSION_NAME": "<AGENT_BROWSER_SESSION_NAME>",
                "AGENT_BROWSER_SHOW_WINDOW": "<AGENT_BROWSER_SHOW_WINDOW>",
                "MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e AGENT_BROWSER_SESSION_NAME=<AGENT_BROWSER_SESSION_NAME> -e AGENT_BROWSER_SHOW_WINDOW=<AGENT_BROWSER_SHOW_WINDOW> -e MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> browser-automation npx -y @mindstone/mcp-server-browser-automation
```
Replace <…> with your own values

## When to use it
- open a page and retrieve its title
- fill in a website form
- capture the current page
- save a page as a PDF in the workspace
- switch to another browser tab

## Example prompts
- Open the sign-in page and wait while I log in.
- Fill in the form on the current page with these details, then show me a screenshot before submitting.
- Save the current page as a PDF in the workspace.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 13345

From the same set: [mindstone/mcp-servers](https://affpapa.org/en/nevibecode/by/mindstone/mcp-servers.md) — 24 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md