# browserbasehq-mcp-browserbase MCP server

Provides cloud browser automation capabilities using Stagehand and Browserbase, enabling LLMs to i…

## At a glance

browserbasehq-mcp-browserbase is an MCP server in the Web & Search category. It is hosted remotely and connects over HTTP, and needs Authorization. It exposes 6 tools, including start, end and navigate. It scores B (66/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install browserbasehq-mcp-browserbase in Claude Code

1. Add the server

```bash
claude mcp add --transport http browserbasehq-mcp-browserbase https://server.smithery.ai/@browserbasehq/mcp-browserbase/mcp --header 'Authorization: Bearer <YOUR_TOKEN>'
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Verify it's connected

```bash
claude mcp list
```

4. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

5. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. start, end, navigate). It discovers them automatically.

### How to install browserbasehq-mcp-browserbase in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "browserbasehq-mcp-browserbase": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://server.smithery.ai/@browserbasehq/mcp-browserbase/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

4. Why the wrapper?

   This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.

5. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install browserbasehq-mcp-browserbase in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "browserbasehq-mcp-browserbase": {
      "url": "https://server.smithery.ai/@browserbasehq/mcp-browserbase/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install browserbasehq-mcp-browserbase in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.browserbasehq-mcp-browserbase]
command = "npx"
args = ["-y", "mcp-remote", "https://server.smithery.ai/@browserbasehq/mcp-browserbase/mcp", "--header", "Authorization:${AUTH_HEADER}"]
env = { AUTH_HEADER = "Bearer <YOUR_TOKEN>" }
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Why the wrapper?

   Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.

4. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install browserbasehq-mcp-browserbase in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "browserbasehq-mcp-browserbase": {
      "serverUrl": "https://server.smithery.ai/@browserbasehq/mcp-browserbase/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install browserbasehq-mcp-browserbase in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "browserbasehq-mcp-browserbase": {
      "type": "streamableHttp",
      "url": "https://server.smithery.ai/@browserbasehq/mcp-browserbase/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

### How to install browserbasehq-mcp-browserbase in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "browserbasehq-mcp-browserbase": {
      "type": "http",
      "url": "https://server.smithery.ai/@browserbasehq/mcp-browserbase/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `start` — Create or reuse a Browserbase session
- `end` — Close the current Browserbase session
- `navigate` — Navigate to a URL
- `act` — Perform an action on the page
- `observe` — Observe actionable elements on the page
- `extract` — Extract data from the page

Source repository: https://github.com/browserbase/mcp-server-browserbase

---

Source: https://mcp-skills-hub.vercel.app/mcps/ai-smithery-browserbasehq-mcp-browserbase · MCP Skills Hub · data as of 2026-10-28T12:31:05Z