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.

OTHER DEV TOOLS MCP SERVERS

Official5

GitHub

GitHub

Official GitHub MCP server. 29,469 stars, MIT, 33 commits on main in the last 30 days. Repo, issue, PR, action, and code search tools backed by the GitHub REST + GraphQL APIs.

24 tools29,469
Official4.7

Playwright

Microsoft

Official Microsoft Playwright MCP server. Browser automation tools (navigate, click, fill, screenshot, evaluate JS, network capture) backed by Playwright. 31,942 stars, 35 commits/30d, Apache-2.0.

11 tools31,942
Official4.7

FastMCP (Python)

PrefectHQ

The fast, Pythonic way to build MCP servers and clients. Maintained by PrefectHQ. 25,133 GitHub stars and 92 commits on main in the last 30 days. The dominant Python MCP framework.

5 tools25,133
Community4.7

Repomix

yamadashy (community)

Pack the entire repository into a single AI-friendly file. Optimised context for feeding codebases to Claude, ChatGPT, Gemini, and others. 24,515 GitHub stars and 100 commits on main in the last 30 days.

5 tools24,515
Community4.7

Serena

oraios (community)

Powerful MCP toolkit for coding. Provides semantic retrieval and editing capabilities, positioned as the IDE for the agent. 23,971 GitHub stars and 100 commits on main in the last 30 days.

7 tools23,971
Official4.7

Model Context Protocol Specification

Model Context Protocol

The official specification and documentation for the Model Context Protocol. The source of truth for the protocol that every MCP server in this directory implements. 8,090 GitHub stars and 100 commits on main in the last 30 days.

4 tools8,090
// 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 →