Browserbase MCP
This server provides cloud browser automation capabilities using Browserbase, Puppeteer, and Stagehand. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a cloud browser environment.
What is Browserbase MCP?
Browserbase MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this server provides cloud browser automation capabilities using browserbase, puppeteer, and stagehand. this server enables llms to interact with web pages, take screenshots, and execute javascript in...
This server provides cloud browser automation capabilities using Browserbase, Puppeteer, and Stagehand. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a cloud browser environment.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- browserbase_session_create
- browserbase_session_close
- browserbase_stagehand_navigate
- browserbase_stagehand_act
- browserbase_stagehand_extract
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @browserbasehq/mcp-server-browserbaseManual Installation
npx -y @browserbasehq/mcp-server-browserbaseConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Browserbase MCP
The Browserbase MCP server gives AI assistants full cloud browser automation capabilities by connecting them to Browserbase's remote Chrome infrastructure via the Stagehand framework. LLMs can navigate to URLs, observe interactive elements on a page, perform click and form actions, extract structured data, and take screenshots — all without running a local browser. This makes it well-suited for research automation, web scraping, and agentic workflows that require real browser rendering rather than raw HTTP fetches.
Prerequisites
- Node.js 18+ to run the server via npx
- A Browserbase account with a valid API key (sign up at browserbase.com)
- A Browserbase Project ID from your dashboard
- A Gemini API key (default model) or an alternative model API key if overriding the default
- An MCP-compatible client such as Claude Desktop
Create a Browserbase account and project
Sign up at browserbase.com, create a new project, and copy your API key and Project ID from the dashboard. These credentials are required for every browser session.
Test the server locally
Run the server directly with npx to confirm your credentials work before adding it to a client config.
BROWSERBASE_API_KEY=your_api_key \
BROWSERBASE_PROJECT_ID=your_project_id \
npx -y @browserbasehq/mcp-server-browserbaseAdd the server to Claude Desktop configuration
Edit your claude_desktop_config.json to include the Browserbase server with your credentials passed as environment variables.
{
"mcpServers": {
"browserbase": {
"command": "npx",
"args": ["-y", "@browserbasehq/mcp-server-browserbase"],
"env": {
"BROWSERBASE_API_KEY": "your_api_key",
"BROWSERBASE_PROJECT_ID": "your_project_id",
"GEMINI_API_KEY": "your_gemini_api_key"
}
}
}
}Restart Claude Desktop
Fully quit and relaunch Claude Desktop so it connects to the Browserbase MCP server. You should see it listed in the available tools.
Start a browser session and navigate
Once connected, ask Claude to open a browser session and navigate to a URL. The server will create a Browserbase cloud session and return the page content.
Browserbase MCP Examples
Client configuration
Full claude_desktop_config.json block for the Browserbase MCP server with all required environment variables.
{
"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"
}
}
}
}Prompts to try
These prompts demonstrate the browser automation tools the server exposes.
- "Open a browser session and navigate to https://news.ycombinator.com, then list the top 5 story titles"
- "Go to https://example.com/login, fill in the email field with [email protected], and click the Sign In button"
- "Extract all product names and prices from https://books.toscrape.com"
- "Take a screenshot of https://anthropic.com and describe what you see"
- "Observe all clickable elements on the current page and tell me what actions are available"Troubleshooting Browserbase MCP
Session creation fails with 401 Unauthorized
Double-check that BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID are both set correctly. The Project ID is a UUID found in your Browserbase dashboard under project settings, not the project name.
The observe or act tools return empty results or fail to find elements
Some pages require JavaScript to fully render. Try adding a brief wait instruction in your prompt ('wait for the page to fully load before extracting'). If the page uses anti-bot measures, enable proxies by passing --proxies in the server args.
GEMINI_API_KEY errors even though you want to use a different model
Pass --modelName and --modelApiKey as additional args to override the default Gemini model: add "--modelName", "claude-3-5-sonnet-20241022", "--modelApiKey", "your_anthropic_key" to the args array.
Frequently Asked Questions about Browserbase MCP
What is Browserbase MCP?
Browserbase MCP is a Model Context Protocol (MCP) server that this server provides cloud browser automation capabilities using browserbase, puppeteer, and stagehand. this server enables llms to interact with web pages, take screenshots, and execute javascript in a cloud browser environment. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Browserbase MCP?
Install via npm with the command: npx -y @browserbasehq/mcp-server-browserbase. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Browserbase MCP?
Browserbase MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Browserbase MCP free to use?
Yes, Browserbase MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Browserbase MCP Alternatives — Similar Browser Automation Servers
Looking for alternatives to Browserbase MCP? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Browserbase MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Browserbase MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.