Installation
BrowserControl needs Python 3.11 or newer and runs on Linux, macOS, and Windows. Allow about 300 MB if it has to download Chromium.
Choose how to run it
Most people don't install anything: their MCP client runs uvx browsercontrol, which fetches the package on first use. Install it yourself when you want a fixed version or a command on your PATH.
# Nothing to install. Use this as your client's command:
uvx browsercontroluv tool install browsercontrol
# If uv warns that its tool directory is not on PATH:
uv tool update-shellpython -m pip install browsercontrolpipx install browsercontrolgit clone https://github.com/adityasasidhar/browsercontrol
cd browsercontrol
uv sync
# Client command: uv --directory /absolute/path/to/browsercontrol run browsercontrolIf you install into a virtual environment, give your MCP client the full path to that environment's browsercontrol executable.
Check the install:
browsercontrol --helpHow it picks a browser
On first launch BrowserControl looks for a browser in this order:
- The binary in
BROWSER_EXECUTABLE_PATH, if you set one. - Playwright's cached Chromium.
- An installed Google Chrome, run with its own separate profile so your everyday Chrome data is never touched.
- If none of those start, it downloads Chromium.
With BROWSER_EXTENSION_PATH set, automatic selection uses Playwright's Chromium, since extensions need it.
To download Chromium ahead of time, run this in an environment that has Playwright (prefix with uv run inside a uv project):
python -m playwright install chromiumLinux needs extra libraries?
Chromium depends on system libraries that minimal Linux images often lack. Install them with:
python -m playwright install chromium --with-depsIf Playwright has no Chromium build for your distribution, point BROWSER_EXECUTABLE_PATH at a Chrome or Chromium you already have. See Troubleshooting.
BrowserControl is listed in the official MCP Registry as io.github.adityasasidhar/browsercontrol.
