AUTOMATIONSWITCH
CommunityDev Tools

BB Browser

by epiral (community)

Your browser is the API. CLI and MCP server for AI agents to control Chrome with your own profile, cookies, and extensions. 5,108 GitHub stars and 8 commits on main in the last 30 days.

5,108·6 tools·Released AUG 2025·MIT
npx -y bb-browser
Share:

Your browser is the API. CLI and MCP server for AI agents to control Chrome with your own profile, cookies, and extensions. 5,108 stars and 8 commits on main in the last 30 days.

Reviewed by M. Nouriel · MAY 2026

INSTALL THIS SERVER

{ "mcpServers": { "bb-browser": { "command": "npx", "args": [ "-y", "bb-browser" ] } } }
PrereqNPM: `bb-browser`. Use a dedicated Chrome profile for agent work; avoid the profile with sensitive logged-in sessions. Path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).
{ "mcpServers": { "bb-browser": { "command": "npx", "args": [ "-y", "bb-browser" ] } } }
{ "mcpServers": { "bb-browser": { "command": "npx", "args": [ "-y", "bb-browser" ] } } }
{ "mcpServers": { "bb-browser": { "command": "npx", "args": [ "-y", "bb-browser" ] } } }
{ "mcpServers": { "bb-browser": { "command": "npx", "args": [ "-y", "bb-browser" ] } } }

6 TOOLS AVAILABLE

attach_chrome
Attach BB Browser to an existing Chrome profile
Admin
navigate
Navigate to a URL within the attached profile
Admin
screenshot
Capture a screenshot of the current page
Read
run_action
Execute a CDP action (click, type, scroll) against the page
Admin
get_dom
Retrieve the rendered DOM as accessibility tree
Read
list_cookies
List cookies for the current profile and domain
Read

OUR ASSESSMENT

Strengths
  • 5,108 GitHub stars.
  • 8 commits on main in the last 30 days.
  • MIT license.
  • Profile-aware: inherits cookies, sessions, extensions.
  • CLI plus MCP makes it usable outside agent loops too.
Weaknesses
  • Attaches to your real Chrome profile; agent mistakes can affect your actual browsing state.
  • Profile attachment requires Chrome restart on first connection.
  • Less suitable for headless CI workflows (use Playwright or Browserbase instead).
Security Notes

BB Browser inherits the full Chrome profile permissions; treat the agent flow as having access to every logged-in site. Prefer a dedicated Chrome profile for agent work rather than your personal browsing profile. Sensitive sessions (banking, password managers) should never be in the attached profile.

Best For

Tasks that require existing authentication state (logged into LinkedIn, Gmail, internal SaaS); reverse-engineering workflows where extensions matter; personal-assistant agents that need access to your real browser session.

TECHNICAL DETAILS

Language
typescript
Transport
stdio
Clients
Claude DesktopClaude CodeCursorVS CodeWindsurf
License
MIT
GitHub
epiral/bb-browser · ★ 5,108
npm
bb-browser
Last Release
bb-browser (npm latest)MAY 12, 2026
First Released
AUG 1, 2025

ADOPTION METRICS

// GitHub Stars
5,108

// Reading this5,108 stars on epiral/bb-browser. 8 commits on main in the last 30 days.

// Popularity Rank
#6
Globally · #6 in Dev Tools

// Reading thisPairs with Chrome DevTools MCP, Playwright, Browserbase, Windows MCP, Mobile MCP, BrowserStack in dev-tools. BB Browser owns the profile-aware-browser-attach slot.

SOURCES & VERIFICATION

We don't take any single directory's word for it. Before scoring, we cross-reference 4 public MCP sources, install the server ourselves against the clients we cover, and record when we last re-verified.

01
Discovered
Manual submission
First indexed MAY 12, 2026
02
Cross-referenced
4 directories
PulseMCP, MCP.so, Glama, Smithery
03
Verified against
Claude Desktop, Cursor
Installed and tested across clients
04
Last re-checked
MAY 12, 2026
Weekly re-verification
// How other directories see it

The same server, 4 different lenses. We reconcile these signals into our editorial score, which is why our number sometimes diverges from a directory-aggregate star count.

SourceTheir ratingTheir star countTheir downloadsLast synced
AutomationSwitch This page4.4editorial5,108MAY 12, 2026
PulseMCP— unratedunavailableunavailableMAY 12, 2026
MCP.so— unratedunavailableunavailableMAY 12, 2026
Glama— unratedunavailableunavailableMAY 12, 2026
Smithery— unratedunavailableunavailableMAY 12, 2026

// Counts are directory-reported; we don't adjust them. Discrepancies usually come from different snapshot times or star-caching.

// Get in touch

DISCUSS YOUR
MCP REQUIREMENTS.

Evaluating a server, scoping an internal deployment, or working out whether MCP is the right fit at all. Start the conversation and we will point you at the right piece of the ecosystem.

Discuss Your MCP Requirements →