BB Browser
Your browser is the API. CLI + MCP server for AI agents to control Chrome with your login state.
What is BB Browser?
BB Browser is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to your browser is the api. cli + mcp server for ai agents to control chrome with your login state.
Your browser is the API. CLI + MCP server for AI agents to control Chrome with your login state.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Your browser is the API. CLI + MCP server for AI agents to c
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx bb-browserConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use BB Browser
BB Browser is a CLI and MCP server that lets AI agents control your existing Chrome browser — with your real login sessions intact — across 36 platforms using 103 built-in commands. Instead of requiring API keys or OAuth flows, it reuses your browser's cookies and session state to access Twitter, GitHub, YouTube, arXiv, finance sites, and more. Agents can search, extract data, take screenshots, click elements, fill forms, execute JavaScript, and monitor network traffic, all through a single authenticated browser connection running on your machine.
Prerequisites
- Node.js 18 or later
- Google Chrome installed and logged in to the services you want to automate
- An MCP-compatible AI client such as Claude Desktop, Claude Code, or Cursor
- No API keys required — bb-browser uses your existing browser login state
Install bb-browser globally
Install the package globally with npm so the bb-browser CLI is available system-wide.
npm install -g bb-browserVerify the installation
Confirm bb-browser is installed and check the list of supported platform commands.
bb-browser --helpTest a quick search command
Run a standalone search to confirm your browser state is being picked up correctly. This fetches GitHub search results using your browser session.
bb-browser site github/search mcp-serverAdd to your MCP client configuration
Configure bb-browser as an MCP server in your client's config file. The server binds to 127.0.0.1:19824 by default.
{
"mcpServers": {
"bb-browser": {
"command": "npx",
"args": ["bb-browser"]
}
}
}Restart your MCP client
Restart Claude Desktop or your chosen MCP client to load the new server configuration. BB Browser will start automatically when the client launches.
BB Browser Examples
Client configuration
Add bb-browser to your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).
{
"mcpServers": {
"bb-browser": {
"command": "npx",
"args": ["bb-browser"]
}
}
}Prompts to try
After configuring bb-browser, use these prompts to leverage its browser automation capabilities.
- "Search Twitter for 'MCP servers' and summarize the top 5 results."
- "Get the transcript for this YouTube video: https://youtube.com/watch?v=VIDEO_ID"
- "Search arXiv for recent papers on RAG and list the titles and abstracts."
- "Take a screenshot of my GitHub notifications page."
- "Search GitHub for open-source MCP server implementations and list the most starred repos."Troubleshooting BB Browser
Commands return authentication errors even though you are logged in to Chrome
BB Browser uses your default Chrome profile. Make sure Chrome is closed or that bb-browser can access the profile directory. On macOS, check that the terminal has Full Disk Access in System Settings > Privacy & Security.
Port 19824 is already in use and the daemon won't start
Start bb-browser with a custom port by passing --host and a different port. Update your MCP config args accordingly to point to the new port.
A supported platform returns empty results
The platform may have changed its page structure. Update bb-browser with npm install -g bb-browser@latest to get the newest command definitions, and retry.
Frequently Asked Questions about BB Browser
What is BB Browser?
BB Browser is a Model Context Protocol (MCP) server that your browser is the api. cli + mcp server for ai agents to control chrome with your login state. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install BB Browser?
Follow the installation instructions on the BB Browser GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with BB Browser?
BB Browser works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is BB Browser free to use?
Yes, BB Browser is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
BB Browser Alternatives — Similar Browser Automation Servers
Looking for alternatives to BB Browser? 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 BB Browser 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 BB Browser?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.