
Browser Mcp Cdp
Drives your local Chrome via CDP with a clever profile snapshot system: it copies your real Chrome cookies and login state to a temp directory, so agents can navigate Gmail or internal dashboards without touching your actual profile. Ships a shared broker process that multiple MCP clients connect to over a Unix socket, avoiding the overhead of launching Chrome per session. Exposes navigate, evaluate, screenshot, click, fill, and tab management tools. The tradeoff is clear: you get access to your logged-in sessions without credential uploads, but you're letting the LLM execute JavaScript in a browser that sees your session tokens. Broker idles out after 10 minutes and cleans up the temp profile.
- tools
- 13
- transport
- STDIO
- last updated
- Apr 23, 2026
Tools
13 toolsPublic tool metadata for what this MCP can expose to an agent.
browser_navigateLoad a URL, return final URL + title
Load a URL, return final URL + title
No parameter schema in public metadata yet.
browser_evaluateRun JS in the page, return result
Run JS in the page, return result
No parameter schema in public metadata yet.
browser_screenshotPNG of current page
PNG of current page
No parameter schema in public metadata yet.
browser_clickClick via CSS selector
Click via CSS selector
No parameter schema in public metadata yet.
browser_click_atClick at pixel coordinates (pierces iframes / overlays)
Click at pixel coordinates (pierces iframes / overlays)
No parameter schema in public metadata yet.
browser_fillSet value on input/textarea/select
Set value on input/textarea/select
No parameter schema in public metadata yet.
browser_wait_forWait for a selector to appear
Wait for a selector to appear
No parameter schema in public metadata yet.
browser_get_urlCurrent URL
Current URL
No parameter schema in public metadata yet.
browser_get_textVisible text of page or element
Visible text of page or element
No parameter schema in public metadata yet.
browser_get_htmlouterHTML of page or element
outerHTML of page or element
No parameter schema in public metadata yet.
browser_scrollScroll by (x, y) pixels
Scroll by (x, y) pixels
No parameter schema in public metadata yet.
browser_tabsList open tabs
List open tabs
No parameter schema in public metadata yet.
browser_new_tabOpen a new tab
Open a new tab
No parameter schema in public metadata yet.
Sponsors
Readme
browser-mcp-cdp
A Model Context Protocol (MCP) server that drives your real local Chrome via the Chrome DevTools Protocol. Designed for agents that need access to your logged-in sessions (Gmail, internal dashboards, banking, etc.) without uploading credentials to a cloud service.
Why another browser MCP?
Different tradeoffs from the alternatives:
| browser-mcp-cdp | Playwright MCP | Chrome DevTools MCP | |
|---|---|---|---|
| Browser | Your local Chrome | Managed Playwright Chromium | Your local Chrome |
| Login state | ✅ Snapshot of your profile (cookies, logins, IndexedDB) | ❌ Fresh profile | ✅ Real profile (modifies it) |
| Profile isolation | ✅ Copy-on-start, real profile untouched | N/A | ⚠️ Direct attach |
| Multi-client | ✅ Shared broker across MCP clients | ❌ Per-client | ❌ Per-client |
| Dependencies | Node only (no Playwright download) | Playwright + browsers | Node only |
The profile snapshot pattern means you can ask an agent to "check my email" — it sees your Gmail logged in — but the agent's actions never modify your real Chrome profile. Each session gets a disposable copy.
Install
claude mcp add browser -- npx -y browser-mcp-cdp
Details
- Repository
- github.com/zhiqi-li/browser-mcp-cdp
- Category
- Web & Browser Automation
- Package
browser-mcp-cdp- Transport
- STDIO
- Registry
- MCP registry, active