browser-devtools-mcp: Install & Tools

Install

Connection

Transport: STDIO, HTTP
Endpoint: https://{your_mcp_server_host}/mcp
Command: npx -y browser-devtools-mcp
Environment: { "PLATFORM": "YOUR_VALUE_HERE", "PORT": "YOUR_VALUE_HERE", "SESSION_IDLE_SECONDS": "YOUR_VALUE_HERE", "SESSION_IDLE_CHECK_SECONDS": "YOUR_VALUE_HERE", "SESSION_CLOSE_ON_SOCKET_CLOSE": "YOUR_VALUE_HERE", "CONSOLE_MESSAGES_BUFFER_SIZE": "YOUR_VALUE_HERE", "HTTP_REQUESTS_BUFFER_SIZE": "YOUR_VALUE_HERE", "BROWSER_SERVER_INSTRUCTIONS_ENABLE": "YOUR_VALUE_HERE", "BROWSER_POLICY_UI_DEBUGGING_ENABLE": "YOUR_VALUE_HERE", "BROWSER_HEADLESS_ENABLE": "YOUR_VALUE_HERE", "BROWSER_PERSISTENT_ENABLE": "YOUR_VALUE_HERE", "BROWSER_CDP_ENDPOINT_URL": "YOUR_VALUE_HERE", "BROWSER_CDP_ENABLE": "YOUR_VALUE_HERE", "BROWSER_CDP_OPEN_INSPECT": "YOUR_VALUE_HERE", "BROWSER_PERSISTENT_USER_DATA_DIR": "YOUR_VALUE_HERE", "BROWSER_USE_INSTALLED_ON_SYSTEM": "YOUR_VALUE_HERE", "BROWSER_EXECUTABLE_PATH": "YOUR_VALUE_HERE", "BROWSER_CHROMIUM_SANDBOX": "YOUR_VALUE_HERE", "BROWSER_LAUNCH_ARGS": "YOUR_VALUE_HERE", "BROWSER_ALLOWED_DOMAINS": "YOUR_VALUE_HERE", "BROWSER_LOCALE": "YOUR_VALUE_HERE", "OTEL_ENABLE": "YOUR_VALUE_HERE", "OTEL_SERVICE_NAME": "YOUR_VALUE_HERE", "OTEL_SERVICE_VERSION": "YOUR_VALUE_HERE", "OTEL_ASSETS_DIR": "YOUR_VALUE_HERE", "OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS": "YOUR_VALUE_HERE", "OTEL_EXPORTER_TYPE": "YOUR_VALUE_HERE", "OTEL_EXPORTER_HTTP_URL": "YOUR_VALUE_HERE", "OTEL_EXPORTER_HTTP_HEADERS": "YOUR_SECRET_VALUE", "AWS_REGION": "YOUR_VALUE_HERE", "AWS_PROFILE": "YOUR_VALUE_HERE", "AMAZON_BEDROCK_ENABLE": "YOUR_VALUE_HERE", "AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID": "YOUR_VALUE_HERE", "AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID": "YOUR_VALUE_HERE", "AMAZON_BEDROCK_VISION_MODEL_ID": "YOUR_VALUE_HERE", "FIGMA_ACCESS_TOKEN": "YOUR_SECRET_VALUE", "FIGMA_API_BASE_URL": "YOUR_VALUE_HERE", "DAEMON_PORT": "YOUR_VALUE_HERE", "DAEMON_SESSION_IDLE_SECONDS": "YOUR_VALUE_HERE", "DAEMON_SESSION_IDLE_CHECK_SECONDS": "YOUR_VALUE_HERE", "NODE_SERVER_INSTRUCTIONS_ENABLE": "YOUR_VALUE_HERE", "NODE_POLICY_DEBUGGING_ENABLE": "YOUR_VALUE_HERE", "NODE_INSPECTOR_HOST": "YOUR_VALUE_HERE", "TOOL_OUTPUT_SCHEMA_DISABLE": "YOUR_VALUE_HERE", "AVAILABLE_TOOL_DOMAINS": "YOUR_VALUE_HERE", "WORKING_DIR": "YOUR_VALUE_HERE", "SEARCH_STRATEGY": "YOUR_VALUE_HERE", "SCENARIO_SEARCH_STRATEGY": "YOUR_VALUE_HERE" }

Variables: your_mcp_server_host

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

{
  "mcpServers": {
    "io-github-serkan-ozal-browser-devtools-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "browser-devtools-mcp"
      ],
      "env": {
        "PLATFORM": "YOUR_VALUE_HERE",
        "PORT": "YOUR_VALUE_HERE",
        "SESSION_IDLE_SECONDS": "YOUR_VALUE_HERE",
        "SESSION_IDLE_CHECK_SECONDS": "YOUR_VALUE_HERE",
        "SESSION_CLOSE_ON_SOCKET_CLOSE": "YOUR_VALUE_HERE",
        "CONSOLE_MESSAGES_BUFFER_SIZE": "YOUR_VALUE_HERE",
        "HTTP_REQUESTS_BUFFER_SIZE": "YOUR_VALUE_HERE",
        "BROWSER_SERVER_INSTRUCTIONS_ENABLE": "YOUR_VALUE_HERE",
        "BROWSER_POLICY_UI_DEBUGGING_ENABLE": "YOUR_VALUE_HERE",
        "BROWSER_HEADLESS_ENABLE": "YOUR_VALUE_HERE",
        "BROWSER_PERSISTENT_ENABLE": "YOUR_VALUE_HERE",
        "BROWSER_CDP_ENDPOINT_URL": "YOUR_VALUE_HERE",
        "BROWSER_CDP_ENABLE": "YOUR_VALUE_HERE",
        "BROWSER_CDP_OPEN_INSPECT": "YOUR_VALUE_HERE",
        "BROWSER_PERSISTENT_USER_DATA_DIR": "YOUR_VALUE_HERE",
        "BROWSER_USE_INSTALLED_ON_SYSTEM": "YOUR_VALUE_HERE",
        "BROWSER_EXECUTABLE_PATH": "YOUR_VALUE_HERE",
        "BROWSER_CHROMIUM_SANDBOX": "YOUR_VALUE_HERE",
        "BROWSER_LAUNCH_ARGS": "YOUR_VALUE_HERE",
        "BROWSER_ALLOWED_DOMAINS": "YOUR_VALUE_HERE",
        "BROWSER_LOCALE": "YOUR_VALUE_HERE",
        "OTEL_ENABLE": "YOUR_VALUE_HERE",
        "OTEL_SERVICE_NAME": "YOUR_VALUE_HERE",
        "OTEL_SERVICE_VERSION": "YOUR_VALUE_HERE",
        "OTEL_ASSETS_DIR": "YOUR_VALUE_HERE",
        "OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS": "YOUR_VALUE_HERE",
        "OTEL_EXPORTER_TYPE": "YOUR_VALUE_HERE",
        "OTEL_EXPORTER_HTTP_URL": "YOUR_VALUE_HERE",
        "OTEL_EXPORTER_HTTP_HEADERS": "YOUR_SECRET_VALUE",
        "AWS_REGION": "YOUR_VALUE_HERE",
        "AWS_PROFILE": "YOUR_VALUE_HERE",
        "AMAZON_BEDROCK_ENABLE": "YOUR_VALUE_HERE",
        "AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID": "YOUR_VALUE_HERE",
        "AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID": "YOUR_VALUE_HERE",
        "AMAZON_BEDROCK_VISION_MODEL_ID": "YOUR_VALUE_HERE",
        "FIGMA_ACCESS_TOKEN": "YOUR_SECRET_VALUE",
        "FIGMA_API_BASE_URL": "YOUR_VALUE_HERE",
        "DAEMON_PORT": "YOUR_VALUE_HERE",
        "DAEMON_SESSION_IDLE_SECONDS": "YOUR_VALUE_HERE",
        "DAEMON_SESSION_IDLE_CHECK_SECONDS": "YOUR_VALUE_HERE",
        "NODE_SERVER_INSTRUCTIONS_ENABLE": "YOUR_VALUE_HERE",
        "NODE_POLICY_DEBUGGING_ENABLE": "YOUR_VALUE_HERE",
        "NODE_INSPECTOR_HOST": "YOUR_VALUE_HERE",
        "TOOL_OUTPUT_SCHEMA_DISABLE": "YOUR_VALUE_HERE",
        "AVAILABLE_TOOL_DOMAINS": "YOUR_VALUE_HERE",
        "WORKING_DIR": "YOUR_VALUE_HERE",
        "SEARCH_STRATEGY": "YOUR_VALUE_HERE",
        "SCENARIO_SEARCH_STRATEGY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Config location

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Auth

Package transport

No remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.

Tools & Resources

Tools

Resources

Prompts

No public tools, resources, or prompts captured yet. Use Auth when this server requires credentials.

Tools

No tools captured yet.

Resources

No resources captured yet.

Prompts

No prompts captured yet.

Questions

What is browser-devtools-mcp?+

browser-devtools-mcp is an MCP server for Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions.. It supports STDIO, HTTP transport.

How do I install browser-devtools-mcp?+

Use the generated config in Install. This server runs with npx -y browser-devtools-mcp; add any required environment variables before starting your client.

How do I add browser-devtools-mcp to Claude Desktop?+

Choose the Claude Desktop tab in Install, copy the config, and add it to Claude Desktop's MCP server settings. Endpoint: https://{your_mcp_server_host}/mcp.

How do I add browser-devtools-mcp to Claude Code?+

Choose the Claude Code tab in Install, copy the config, and add it to Claude Code's MCP server settings. Endpoint: https://{your_mcp_server_host}/mcp.

How do I use browser-devtools-mcp with Codex?+

Choose the Codex tab in Install, copy the config, and add it to Codex's MCP server settings. Endpoint: https://{your_mcp_server_host}/mcp.

How do I add browser-devtools-mcp to Cursor or VS Code?+

Choose the Cursor or VS Code tab in Install, copy the config, and add it to Cursor or VS Code's MCP server settings. Endpoint: https://{your_mcp_server_host}/mcp.

What endpoint and transport does browser-devtools-mcp use?+

browser-devtools-mcp uses STDIO, HTTP transport. Endpoint: https://{your_mcp_server_host}/mcp.

What tools and resources does browser-devtools-mcp expose?+

browser-devtools-mcp inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.

Does browser-devtools-mcp require authentication?+

browser-devtools-mcp does not advertise a verified auth requirement. If discovery fails, it may still need provider login, an API key, a bearer token, or a session header.

Profile notes

Remote URL variable: your_mcp_server_host (required)
Package: Npm browser-devtools-mcp v0.9.1
Environment variable: PLATFORM
Environment variable: PORT
Environment variable: SESSION_IDLE_SECONDS
Environment variable: SESSION_IDLE_CHECK_SECONDS
Environment variable: SESSION_CLOSE_ON_SOCKET_CLOSE
Environment variable: CONSOLE_MESSAGES_BUFFER_SIZE
Environment variable: HTTP_REQUESTS_BUFFER_SIZE
Environment variable: BROWSER_SERVER_INSTRUCTIONS_ENABLE
Environment variable: BROWSER_POLICY_UI_DEBUGGING_ENABLE
Environment variable: BROWSER_HEADLESS_ENABLE
Environment variable: BROWSER_PERSISTENT_ENABLE
Environment variable: BROWSER_CDP_ENDPOINT_URL
Environment variable: BROWSER_CDP_ENABLE
Environment variable: BROWSER_CDP_OPEN_INSPECT
Environment variable: BROWSER_PERSISTENT_USER_DATA_DIR
Environment variable: BROWSER_USE_INSTALLED_ON_SYSTEM
Environment variable: BROWSER_EXECUTABLE_PATH
Environment variable: BROWSER_CHROMIUM_SANDBOX
Environment variable: BROWSER_LAUNCH_ARGS
Environment variable: BROWSER_ALLOWED_DOMAINS
Environment variable: BROWSER_LOCALE
Environment variable: OTEL_ENABLE
Environment variable: OTEL_SERVICE_NAME
Environment variable: OTEL_SERVICE_VERSION
Environment variable: OTEL_ASSETS_DIR
Environment variable: OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS
Environment variable: OTEL_EXPORTER_TYPE
Environment variable: OTEL_EXPORTER_HTTP_URL
Environment variable: OTEL_EXPORTER_HTTP_HEADERS (secret)
Environment variable: AWS_REGION
Environment variable: AWS_PROFILE
Environment variable: AMAZON_BEDROCK_ENABLE
Environment variable: AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID
Environment variable: AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID
Environment variable: AMAZON_BEDROCK_VISION_MODEL_ID
Environment variable: FIGMA_ACCESS_TOKEN (secret)
Environment variable: FIGMA_API_BASE_URL
Environment variable: DAEMON_PORT
Environment variable: DAEMON_SESSION_IDLE_SECONDS
Environment variable: DAEMON_SESSION_IDLE_CHECK_SECONDS
Environment variable: NODE_SERVER_INSTRUCTIONS_ENABLE
Environment variable: NODE_POLICY_DEBUGGING_ENABLE
Environment variable: NODE_INSPECTOR_HOST
Environment variable: TOOL_OUTPUT_SCHEMA_DISABLE
Environment variable: AVAILABLE_TOOL_DOMAINS
Environment variable: WORKING_DIR
Environment variable: SEARCH_STRATEGY
Environment variable: SCENARIO_SEARCH_STRATEGY

Packages

Package	Registry	Version	Inputs
`browser-devtools-mcp` stdio	npm	0.9.1	Env: PLATFORM Env: PORT Env: SESSION_IDLE_SECONDS Env: SESSION_IDLE_CHECK_SECONDS Env: SESSION_CLOSE_ON_SOCKET_CLOSE Env: CONSOLE_MESSAGES_BUFFER_SIZE Env: HTTP_REQUESTS_BUFFER_SIZE Env: BROWSER_SERVER_INSTRUCTIONS_ENABLE Env: BROWSER_POLICY_UI_DEBUGGING_ENABLE Env: BROWSER_HEADLESS_ENABLE Env: BROWSER_PERSISTENT_ENABLE Env: BROWSER_CDP_ENDPOINT_URL Env: BROWSER_CDP_ENABLE Env: BROWSER_CDP_OPEN_INSPECT Env: BROWSER_PERSISTENT_USER_DATA_DIR Env: BROWSER_USE_INSTALLED_ON_SYSTEM Env: BROWSER_EXECUTABLE_PATH Env: BROWSER_CHROMIUM_SANDBOX Env: BROWSER_LAUNCH_ARGS Env: BROWSER_ALLOWED_DOMAINS Env: BROWSER_LOCALE Env: OTEL_ENABLE Env: OTEL_SERVICE_NAME Env: OTEL_SERVICE_VERSION Env: OTEL_ASSETS_DIR Env: OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTS Env: OTEL_EXPORTER_TYPE Env: OTEL_EXPORTER_HTTP_URL Env: OTEL_EXPORTER_HTTP_HEADERS secret Env: AWS_REGION Env: AWS_PROFILE Env: AMAZON_BEDROCK_ENABLE Env: AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID Env: AMAZON_BEDROCK_TEXT_EMBED_MODEL_ID Env: AMAZON_BEDROCK_VISION_MODEL_ID Env: FIGMA_ACCESS_TOKEN secret Env: FIGMA_API_BASE_URL Env: DAEMON_PORT Env: DAEMON_SESSION_IDLE_SECONDS Env: DAEMON_SESSION_IDLE_CHECK_SECONDS Env: NODE_SERVER_INSTRUCTIONS_ENABLE Env: NODE_POLICY_DEBUGGING_ENABLE Env: NODE_INSPECTOR_HOST Env: TOOL_OUTPUT_SCHEMA_DISABLE Env: AVAILABLE_TOOL_DOMAINS Env: WORKING_DIR Env: SEARCH_STRATEGY Env: SCENARIO_SEARCH_STRATEGY

Details

Version: 0.9.1
Repository: https://github.com/serkan-ozal/browser-devtools-mcp
Website: https://github.com/serkan-ozal/browser-devtools-mcp
Updated: May 12, 2026

browser-devtools-mcp

Install and compare this MCP server

Want MCP integration examples?

Install

Connection

Claude Desktop

Config location

Auth

Tools & Resources

Tools

Resources

Prompts

Questions

Related MCPs

Profile notes

Packages

Details