bwb-browser-termux

Browser Without Bloat — a lightweight browser automation MCP server using raw Chrome DevTools Protocol (CDP).

No Playwright. No Puppeteer. Just CDP.

Works on Termux/Android, Linux, macOS, and Windows.

Why bwb?

Feature	bwb	Playwright MCP	Puppeteer MCP
Dependencies	3 packages	50+ packages	30+ packages
Install size	~2MB	~500MB+	~300MB+
Works on Termux	✅	❌	❌
Works in CI	✅	⚠️ Needs browser download	⚠️ Needs browser download
Uses existing Chrome	✅	❌ Downloads its own	❌ Downloads its own

Installation

npm install -g bwb-browser-termux

Or run directly:

npx bwb-browser-termux

Prerequisites

You need Chrome or Chromium installed. bwb will auto-detect it.

Termux/Android:

pkg install chromium

Linux (Debian/Ubuntu):

sudo apt install chromium-browser
# or
sudo apt install google-chrome

macOS:

brew install --cask google-chrome

Windows: Download and install Google Chrome normally.

Usage

With Claude Desktop / OpenCode / any MCP client

Add to your MCP client config:

{
  "mcpServers": {
    "bwb": {
      "command": "npx",
      "args": ["bwb-browser-termux"]
    }
  }
}

For Termux, you may need the full path:

{
  "mcpServers": {
    "bwb": {
      "command": "node",
      "args": ["/path/to/bwb-browser-termux/server.js"]
    }
  }
}

Command line

# Start the MCP server (stdio)
bwb

# With custom browser path
bwb --browser-path /usr/bin/chromium

# Custom CDP port
bwb --port 9333

# Visible browser (not headless)
bwb --headless false

# See all options
bwb --help

Configuration

CLI flag	Env var	Default	Description
`--browser-path`	`BWB_CHROME_PATH`	auto-detected	Path to Chrome/Chromium binary
`--port`	`BWB_CDP_PORT`	`9222`	Remote debugging port
`--user-data-dir`	`BWB_USER_DATA_DIR`	`~/.cache/bwb-browser`	Browser profile directory
`--headless`	`BWB_HEADLESS`	`true`	Run headless (`true`/`false`)

Tools (11)

Tool	Description
`browser_goto`	Navigate to a URL
`browser_screenshot`	Take a screenshot
`browser_html`	Get page/selector HTML
`browser_text`	Get page/selector text
`browser_click`	Click an element by CSS selector
`browser_fill`	Fill an input field
`browser_elements`	List interactive elements (links, buttons, inputs, headings)
`browser_title`	Get current page title
`browser_url`	Get current URL
`browser_eval`	Execute JavaScript in page context
`browser_status`	Browser connection status