# Browser MCP server

> Lets an AI client drive your signed-in Chrome, with 40 tools and the ability to pause and ask you for 2FA codes or decisions.

- Repository: https://github.com/Agent360dk/browser-mcp
- Page: https://hostedmcp.org/servers/agent360dk/browser-mcp
- Transport: stdio
- Stars: 64
- License: MIT
- Latest version: 1.31.0

## Install

### Claude Code

```sh
claude mcp add browser-mcp -- npx -y @agent360/browser-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "browser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agent360/browser-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "browser-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agent360/browser-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"browser-mcp","type":"stdio","command":"npx","args":["-y","@agent360/browser-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "browser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agent360/browser-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add browser-mcp -- npx -y @agent360/browser-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.browser-mcp]
command = "npx"
args = ["-y", "@agent360/browser-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user browser-mcp npx -- -y @agent360/browser-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "browser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agent360/browser-mcp"
      ]
    }
  }
}
```

## Tools (40)

- `browser_navigate`
- `browser_get_page_content`
- `browser_screenshot`
- `browser_execute_script`
- `browser_extract_list`
- `browser_click`
- `browser_fill`
- `browser_press_key`
- `browser_scroll`
- `browser_wait`
- `browser_hover`
- `browser_select_option`
- `browser_set_combobox`
- `browser_set_date`
- `browser_dismiss_overlays`
- `browser_handle_dialog`
- `browser_double_click`
- `browser_right_click`
- `browser_click_xy`
- `browser_reattach_debugger`
- `browser_list_tabs`
- `browser_switch_tab`
- `browser_close_tab`
- `browser_get_new_tab`
- `browser_list_frames`
- `browser_select_frame`
- `browser_fetch`
- `browser_wait_for_network`
- `browser_extract_token`
- `browser_solve_captcha`
- `browser_ask_user`
- `browser_get_cookies`
- `browser_set_cookies`
- `browser_get_local_storage`
- `browser_set_local_storage`
- `browser_console_logs`
- `browser_upload_file`
- `browser_drop_file`
- `browser_provide_feedback`
- `browser_about`

## FAQ

### How do I install Browser MCP?

Install the Chrome extension from the Chrome Web Store, register the local MCP server with `claude mcp add --scope user browser-mcp -- npx @agent360/browser-mcp@latest`, then restart Claude Code. Both halves are required.

### Why does the extension say "Not connected"?

That means the local MCP server is not registered yet. The extension needs the server to reach it, so add the server and restart your client.

### Can the agent ask me for a 2FA code or CAPTCHA?

Yes. The browser_ask_user tool pauses and prompts you on your screen for codes, credentials or decisions, then continues in the same session.

### Can several agents use the same Chrome profile at once?

Yes, up to 20 agents can run concurrently, each in its own colour-coded tab group within your logged-in Chrome.

### Do I need to pay or create an account?

No. It is MIT licensed, free, runs on your machine, and sends no telemetry or data to the vendor.