Browser MCP Cdp

Local Chrome via CDP with profile-snapshot isolation and shared-broker multi-client support

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "browser-mcp-cdp": {
      "command": "npx",
      "args": [
        "-y",
        "browser-mcp-cdp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (13)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Browser MCP Cdp.

browser_navigate

Load a URL, return final URL + title

browser_evaluate

Run JS in the page, return result

browser_screenshot

PNG of current page

browser_click

Click via CSS selector

browser_click_at

Click at pixel coordinates (pierces iframes / overlays)

browser_fill

Set value on input/textarea/select

Documentation Overview

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

Terminal

claude mcp add browser -- npx -y browser-mcp-cdp

Or add manually to ~/.claude.json / Claude Desktop config:

config.json

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": ["-y", "browser-mcp-cdp"]
    }
  }
}

Requires Node 18+ and Google Chrome installed.

Tools

Tool	Purpose
`browser_navigate`	Load a URL, return final URL + title
`browser_evaluate`	Run JS in the page, return result
`browser_screenshot`	PNG of current page
`browser_click`	Click via CSS selector
`browser_click_at`	Click at pixel coordinates (pierces iframes / overlays)
`browser_fill`	Set value on input/textarea/select
`browser_wait_for`	Wait for a selector to appear
`browser_get_url`	Current URL
`browser_get_text`	Visible text of page or element
`browser_get_html`	`outerHTML` of page or element
`browser_scroll`	Scroll by `(x, y)` pixels
`browser_tabs`	List open tabs
`browser_new_tab`	Open a new tab

Environment variables

Var	Default
`BROWSER_MCP_CHROME_PATH`	Auto-detected per OS
`BROWSER_MCP_CHROME_PROFILE_ROOT`	OS-standard Chrome profile dir
`BROWSER_MCP_BROKER_SOCKET_PATH`	`~/.browser-mcp/broker.sock`
`BROWSER_MCP_BROKER_LOCK_PATH`	`~/.browser-mcp/broker.lock`
`BROWSER_MCP_BROKER_IDLE_TIMEOUT_MS`	`600000` (10 min)

How it works

First MCP client connection spawns a broker subprocess (detached).
Broker copies your Chrome profile's cookies/local storage/login data to a temp dir.
Broker launches Chrome with --user-data-dir=<temp> and --remote-debugging-port.
Subsequent MCP clients connect to the same broker over a Unix socket → they share one Chrome.
Broker exits after BROKER_IDLE_TIMEOUT_MS of no activity; temp profile is deleted.

Security

This server lets an LLM execute arbitrary JavaScript in a browser that is logged into your accounts. Only use with models and prompts you trust. Profile snapshotting limits damage (no persistent mutations to your real Chrome), but the agent can read cookies, session tokens, and any data visible to logged-in you for the duration of the session.

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit

4mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Browser MCP Cdp

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "browser-mcp-cdp": { "command": "npx", "args": ["-y", "browser-mcp-cdp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/browser-mcp-cdp?style=directory)](https://allmcps.com/mcp/browser-mcp-cdp)

HTML Embed

<a href="https://allmcps.com/mcp/browser-mcp-cdp"><img src="https://allmcps.com/api/badge/browser-mcp-cdp?style=directory" alt="Browser MCP Cdp on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

48Quality signal: Fair · 48/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Browser MCP Cdp →Install in Claude Desktop Install in Cursor Install in VS Code