browser-devtools-mcp
Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions.
Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions.
Use this profile to copy client config, check auth requirements, review tools and resources, and compare related MCP servers before adding it to an AI client.
https://{your_mcp_server_host}/mcpnpx -y browser-devtools-mcp{
"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
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"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
browser-devtools-mcp is an MCP server for Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions.. It supports STDIO, HTTP transport.
Use the generated config in Install. This server runs with npx -y browser-devtools-mcp; add any required environment variables before starting your client.
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.
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.
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.
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.
browser-devtools-mcp uses STDIO, HTTP transport. Endpoint: https://{your_mcp_server_host}/mcp.
browser-devtools-mcp inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
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.
| Package | Registry | Version | Inputs |
|---|---|---|---|
browser-devtools-mcpstdio | 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 |