chrome-bridge — Claude Code MCP server: what it does, install
This MCP server lets an agent work in a tab from your signed-in Chrome. It fits browser forms, audits, and tasks where you take over for 2FA.
claude mcp add chrome-bridge -- npx -y chrome-bridge-mcpWhat chrome-bridge does
chrome-bridge connects Claude Code to a running Chrome session through a local WebSocket bridge. The agent can navigate pages, inspect the DOM, fill forms, locate elements, run audits, compare screenshots, and mock network responses. Tabs opened for the agent are kept separate from your own tabs.
When a page needs a human, handoff displays a banner and pauses the run. You can complete a login, enter 2FA, solve a CAPTCHA, answer a question, or select page elements, then let the agent continue. The setup needs Node.js 18+, Chrome 135+, and the Chrome Bridge extension loaded from extension/ in developer mode.
On Windows, install.sh cannot run from PowerShell or cmd. Error-log hooks also need Python 3.8+ available as python3, python, or py; without it, the browser tools still work while those hooks stay quiet.
What it helps with
- work in a page where Chrome is already signed in
- fill a web form from supplied data
- run accessibility, SEO, or security audits
- locate an element in a large table
- pause for a human 2FA or CAPTCHA step
Example prompts for the agent
- Fill the form in the current tab from
user.json, then hand control to me for 2FA. - Compare the page with the reference image using
screenshot_diffand report the changes.
How to install chrome-bridge
Platform CLI
claude mcp add chrome-bridge -- npx -y chrome-bridge-mcpPlatform CLI
codex mcp add chrome-bridge -- npx -y chrome-bridge-mcpConfig file
{
"mcpServers": {
"chrome-bridge": {
"command": "npx",
"args": [
"-y",
"chrome-bridge-mcp"
]
}
}
}Config file
{
"servers": {
"chrome-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"chrome-bridge-mcp"
]
}
}
}Platform CLI
gemini mcp add chrome-bridge npx -y chrome-bridge-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about chrome-bridge
How do I install chrome-bridge in Claude Code?
Run claude mcp add chrome-bridge -- npx -y chrome-bridge-mcp. Then load the extension from the extension/ folder through chrome://extensions and restart Claude Code.
What does chrome-bridge do?
It connects an agent to a tab in your Chrome session and provides tools for navigation, DOM work, forms, audits, and visual comparison. Human-only actions such as 2FA and CAPTCHA use handoff.
What does chrome-bridge require?
You need Node.js 18+, Chrome 135+, and the browser extension. To use execute_js, turn on Allow user scripts in the extension details.
