browser-devtools-mcp

Name: browser-devtools-mcp
Author: serkan-ozal

Community

MCP server by serkan-ozal · updated 5 months ago · 3.2k downloads a week

Score 49

Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions. browser-devtools-mcp is a community project by serkan-ozal, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Licence

No licence found, so reuse rights are unclear

Quality

Clear description, published package or server URL, original repository

Security

Not checked yet. What we check

What you need

Setting	Needed	What it is
`PLATFORM`Environment variable	Optional	Platform: browser (default) or node for Node.js backend debugging.
`PORT`Environment variable	Optional	Port for HTTP transport.
`SESSION_IDLE_SECONDS`Environment variable	Optional	Idle session timeout (seconds).
`SESSION_IDLE_CHECK_SECONDS`Environment variable	Optional	Interval for checking idle sessions (seconds).
`SESSION_CLOSE_ON_SOCKET_CLOSE`Environment variable	Optional	Close session when socket closes.
`CONSOLE_MESSAGES_BUFFER_SIZE`Environment variable	Optional	Maximum console messages to buffer.
`HTTP_REQUESTS_BUFFER_SIZE`Environment variable	Optional	Maximum HTTP requests to buffer.
`BROWSER_SERVER_INSTRUCTIONS_ENABLE`Environment variable	Optional	When true, include server instructions in MCP server info (browser platform). Default: true.
`BROWSER_POLICY_UI_DEBUGGING_ENABLE`Environment variable	Optional	When true, include UI_DEBUGGING_POLICY in server policies (browser platform). Default: false.
`BROWSER_HEADLESS_ENABLE`Environment variable	Optional	Run browser in headless mode.
`BROWSER_PERSISTENT_ENABLE`Environment variable	Optional	Use persistent browser context (preserves cookies, localStorage, extensions).
`BROWSER_CDP_ENDPOINT_URL`Environment variable	Optional	CDP attach: http(s) root or ws(s) URL. Resolves via /json/version, /json/list, or ws /devtools/browser (Chrome 136+). Mutually exclusive with BROWSER_PERSISTENT_ENABLE.
`BROWSER_CDP_ENABLE`Environment variable	Optional	When true and no BROWSER_CDP_ENDPOINT_URL: probe 127.0.0.1:9222 then :9229 for CDP. Else use BROWSER_CDP_ENDPOINT_URL or default http://127.0.0.1:9222.
`BROWSER_CDP_OPEN_INSPECT`Environment variable	Optional	On loopback CDP failure, if Chrome is running, open chrome://inspect/#remote-debugging. Default true. Set false to disable.
`BROWSER_PERSISTENT_USER_DATA_DIR`Environment variable	Optional	Directory for persistent browser context user data.
`BROWSER_USE_INSTALLED_ON_SYSTEM`Environment variable	Optional	Use system-installed Chrome browser instead of Playwright's bundled browser.
`BROWSER_EXECUTABLE_PATH`Environment variable	Optional	Custom browser executable path.
`BROWSER_CHROMIUM_SANDBOX`Environment variable	Optional	When false, launches Chromium with --no-sandbox. Required for Docker/Lambda/CI.
`BROWSER_LAUNCH_ARGS`Environment variable	Optional	Extra Chromium launch args (comma-separated).
`BROWSER_ALLOWED_DOMAINS`Environment variable	Optional	Comma-separated list of allowed hostnames. When set, all requests to non-matching hosts are aborted. Subdomains match automatically.

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Install browser-devtools-mcp

Built from the published package, never by AI

claude mcp add browser-devtools-mcp -- npx -y browser-devtools-mcp

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install browser-devtools-mcp in Claude Code

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

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install browser-devtools-mcp in Claude Desktop

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

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install browser-devtools-mcp in Cursor

{
  "servers": {
    "browser-devtools-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "browser-devtools-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install browser-devtools-mcp in VS Code

codex mcp add browser-devtools-mcp -- npx -y browser-devtools-mcp

Step-by-step: install browser-devtools-mcp in Codex

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

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install browser-devtools-mcp in Antigravity CLI

gemini mcp add browser-devtools-mcp npx -y browser-devtools-mcp

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install browser-devtools-mcp in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the browser-devtools-mcp block.

Weekly newsletter

Like browser-devtools-mcp? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Alternatives to browser-devtools-mcp

All alternatives →

browser-use browser-use

100

Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.

AAA Local and remote 119k

Actionbook actionbook

Let your AI agent operate any website through a real, logged-in browser session.

AAA Remote 1.6k

Robin: AI-Powered Dark Web OSINTapurvsinghgautam

Dark web OSINT over Tor: search onion engines, scrape pages, report with your own model.

AAA Local 7.6k

Scrapling MCP ServerD4Vinci

Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.

AAA Local 89k

Next AI Draw.ioDayuanJiang

draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand

AAA Local 36k

AIHawkfeder-cr

AI browser agent: browses, clicks, types, and reads real web pages from plain-English instructions.

AAA Local 32k

browser-devtools-mcp vs browser-use browser-devtools-mcp vs Actionbook browser-devtools-mcp vs Robin: AI-Powered Dark Web OSINT

browser-devtools-mcp: common questions

How do I install browser-devtools-mcp?

In Claude Code run claude mcp add browser-devtools-mcp -- npx -y browser-devtools-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is browser-devtools-mcp the official server?

browser-devtools-mcp is a community project by serkan-ozal, not verified by a company domain.

Is browser-devtools-mcp free?

The code is public, but no licence file was found, so check the repository before commercial use.

Is browser-devtools-mcp safe to use?

It scores 49 of 100. Grades: licence F, quality C. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to browser-devtools-mcp?

Does browser-devtools-mcp work with ChatGPT?

Yes. Add its server URL in ChatGPT as a custom connector. See MCP in ChatGPT.