Official server by Browserbase
Browserbase MCP server
Cloud browser automation with Browserbase and Stagehand.
Install
Pick your agent and copy one line. Remote servers ask you to sign in on first use.
claude mcp add browserbase -e BROWSERBASE_API_KEY=YOUR_VALUE -e BROWSERBASE_PROJECT_ID=YOUR_VALUE -e GEMINI_API_KEY=YOUR_VALUE -- npx -y @browserbasehq/mcp-server-browserbase
# ~/.codex/config.toml [mcp_servers.browserbase] command = "npx" args = ["-y", "@browserbasehq/mcp-server-browserbase"] [mcp_servers.browserbase.env] BROWSERBASE_API_KEY = "<your BROWSERBASE_API_KEY>" BROWSERBASE_PROJECT_ID = "<your BROWSERBASE_PROJECT_ID>" GEMINI_API_KEY = "<your GEMINI_API_KEY>"
gemini mcp add -e BROWSERBASE_API_KEY=YOUR_VALUE -e BROWSERBASE_PROJECT_ID=YOUR_VALUE -e GEMINI_API_KEY=YOUR_VALUE browserbase npx -y @browserbasehq/mcp-server-browserbase
{
"mcpServers": {
"browserbase": {
"command": "npx",
"args": [
"-y",
"@browserbasehq/mcp-server-browserbase"
],
"env": {
"BROWSERBASE_API_KEY": "<your BROWSERBASE_API_KEY>",
"BROWSERBASE_PROJECT_ID": "<your BROWSERBASE_PROJECT_ID>",
"GEMINI_API_KEY": "<your GEMINI_API_KEY>"
}
}
}
}code --add-mcp '{"name":"browserbase","command":"npx","args":["-y","@browserbasehq/mcp-server-browserbase"],"env":{"BROWSERBASE_API_KEY":"<your BROWSERBASE_API_KEY>","BROWSERBASE_PROJECT_ID":"<your BROWSERBASE_PROJECT_ID>","GEMINI_API_KEY":"<your GEMINI_API_KEY>"}}'Comparing options? Web scraping MCP servers compared →
Comparing options? Browser automation MCP servers compared →
What it can do
From Browserbase's own MCP documentation.
Sign in
Browserbase API key. Hosted: browserbaseApiKey query parameter. Local: BROWSERBASE_API_KEY env var, plus GEMINI_API_KEY for the default model.
Tools (6)
Options
- Hosted query parameters: modelName (default google/gemini-2.5-flash-lite), modelApiKey, keepAlive, proxies, verified.
- Local flags: --proxies, --verified, --keepAlive, --contextId, --persist, --browserWidth, --browserHeight, --modelName, --modelApiKey, --experimental.
- Local package: npx @browserbasehq/mcp.
Good to know
- The GitHub repo mcp-server-browserbase is archived and no longer maintained. Browserbase recommends the hosted server.
- Pass the sessionId from start on every call. Some clients open a new transport per call and fail with No active session.
- --verified needs the Scale Plan.
- A non-default model needs its own modelApiKey.
- Hosted boolean values must be exact strings.
Details
- Registry name
- io.github.browserbase/mcp-server-browserbase
- Latest version
- 2.1.1 (updated 2025-09-12)
- Packages
@browserbasehq/mcp-server-browserbase (npm)
- Links
- Browserbase docsSource
More in Browser automation
Reviewed Oct 21, 2026. Official means published under Browserbase's namespace in the MCP registry. It is not a security audit.
Built an MCP server? Get it listed everywhere →
Shipping an Android app? Google Play needs 12 testers for 14 days first. Get them with Tester Exchange →