Browser Devtools MCP
Playwright browser & Node.js MCP. ARIA refs, screenshots, ref-based interactions.
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.9.1
- Listing updated
- 4 days ago
About Browser Devtools MCP
Browser Devtools MCP is an open-source MCP server for browser automation. It can run locally on your machine or as a hosted remote server.
Install
Run in a terminal
claude mcp add browser-devtools-mcp --env OTEL_EXPORTER_HTTP_HEADERS='<OTEL_EXPORTER_HTTP_HEADERS>' --env FIGMA_ACCESS_TOKEN='<FIGMA_ACCESS_TOKEN>' -- npx -y browser-devtools-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"browser-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"browser-devtools-mcp"
],
"env": {
"OTEL_EXPORTER_HTTP_HEADERS": "<OTEL_EXPORTER_HTTP_HEADERS>",
"FIGMA_ACCESS_TOKEN": "<FIGMA_ACCESS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"browser-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"browser-devtools-mcp"
],
"env": {
"OTEL_EXPORTER_HTTP_HEADERS": "<OTEL_EXPORTER_HTTP_HEADERS>",
"FIGMA_ACCESS_TOKEN": "<FIGMA_ACCESS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"browser-devtools-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"browser-devtools-mcp"
],
"env": {
"OTEL_EXPORTER_HTTP_HEADERS": "<OTEL_EXPORTER_HTTP_HEADERS>",
"FIGMA_ACCESS_TOKEN": "<FIGMA_ACCESS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"browser-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"browser-devtools-mcp"
],
"env": {
"OTEL_EXPORTER_HTTP_HEADERS": "<OTEL_EXPORTER_HTTP_HEADERS>",
"FIGMA_ACCESS_TOKEN": "<FIGMA_ACCESS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"browser-devtools-mcp": {
"command": "npx",
"args": [
"-y",
"browser-devtools-mcp"
],
"env": {
"OTEL_EXPORTER_HTTP_HEADERS": "<OTEL_EXPORTER_HTTP_HEADERS>",
"FIGMA_ACCESS_TOKEN": "<FIGMA_ACCESS_TOKEN>"
}
}
}
}Configuration
PLATFORMPlatform: browser (default) or node for Node.js backend debugging.PORTPort for HTTP transport.SESSION_IDLE_SECONDSIdle session timeout (seconds).SESSION_IDLE_CHECK_SECONDSInterval for checking idle sessions (seconds).SESSION_CLOSE_ON_SOCKET_CLOSEClose session when socket closes.CONSOLE_MESSAGES_BUFFER_SIZEMaximum console messages to buffer.HTTP_REQUESTS_BUFFER_SIZEMaximum HTTP requests to buffer.BROWSER_SERVER_INSTRUCTIONS_ENABLEWhen true, include server instructions in MCP server info (browser platform). Default: true.BROWSER_POLICY_UI_DEBUGGING_ENABLEWhen true, include UI_DEBUGGING_POLICY in server policies (browser platform). Default: false.BROWSER_HEADLESS_ENABLERun browser in headless mode.BROWSER_PERSISTENT_ENABLEUse persistent browser context (preserves cookies, localStorage, extensions).BROWSER_CDP_ENDPOINT_URLCDP 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_ENABLEWhen 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_INSPECTOn loopback CDP failure, if Chrome is running, open chrome://inspect/#remote-debugging. Default true. Set false to disable.BROWSER_PERSISTENT_USER_DATA_DIRDirectory for persistent browser context user data.BROWSER_USE_INSTALLED_ON_SYSTEMUse system-installed Chrome browser instead of Playwright's bundled browser.BROWSER_EXECUTABLE_PATHCustom browser executable path.BROWSER_CHROMIUM_SANDBOXWhen false, launches Chromium with --no-sandbox. Required for Docker/Lambda/CI.BROWSER_LAUNCH_ARGSExtra Chromium launch args (comma-separated).BROWSER_ALLOWED_DOMAINSComma-separated list of allowed hostnames. When set, all requests to non-matching hosts are aborted. Subdomains match automatically.BROWSER_LOCALEBrowser locale (e.g., "en-US", "tr-TR").OTEL_ENABLEEnable OpenTelemetry integration.OTEL_SERVICE_NAMEOpenTelemetry service name.OTEL_SERVICE_VERSIONOpenTelemetry service version.OTEL_ASSETS_DIRDirectory containing OpenTelemetry bundle files.OTEL_INSTRUMENTATION_USER_INTERACTION_EVENTSUser interaction events to instrument (comma-separated, e.g., "click,submit").OTEL_EXPORTER_TYPEOpenTelemetry exporter type: "otlp/http", "console", or "none".OTEL_EXPORTER_HTTP_URLOpenTelemetry collector base URL (e.g., "http://localhost:4318").OTEL_EXPORTER_HTTP_HEADERSOpenTelemetry exporter HTTP headers (comma-separated key=value pairs).AWS_REGIONAWS region for Bedrock usage.AWS_PROFILEAWS profile name for Bedrock usage.AMAZON_BEDROCK_ENABLEEnable Amazon Bedrock usage.AMAZON_BEDROCK_IMAGE_EMBED_MODEL_IDAmazon Bedrock image embedding model ID.AMAZON_BEDROCK_TEXT_EMBED_MODEL_IDAmazon Bedrock text embedding model ID.AMAZON_BEDROCK_VISION_MODEL_IDAmazon Bedrock vision model ID.FIGMA_ACCESS_TOKENFigma API access token for design comparison.FIGMA_API_BASE_URLFigma API base URL.DAEMON_PORTDaemon mode port (CLI).DAEMON_SESSION_IDLE_SECONDSDaemon mode idle session timeout (seconds).DAEMON_SESSION_IDLE_CHECK_SECONDSDaemon mode idle session check interval (seconds).NODE_SERVER_INSTRUCTIONS_ENABLEWhen true, include server instructions in MCP server info (node platform). Default: true.NODE_POLICY_DEBUGGING_ENABLEWhen true, include NODE_DEBUGGING_POLICY in server policies (node platform). Default: false.NODE_INSPECTOR_HOSTInspector host for debug_connect when MCP runs in Docker (e.g. host.docker.internal). Default: 127.0.0.1.TOOL_OUTPUT_SCHEMA_DISABLEWhen true, omit tool output schema from MCP tool registration (can reduce token usage for some clients).AVAILABLE_TOOL_DOMAINSComma-separated tool domains to enable (e.g. navigation,interaction,a11y,scenario). Unset = all tools. Browser: a11y, content, debug, figma, interaction, navigation, o11y, react, scenario, run, stub, sync. Node: debug, run.WORKING_DIRWorking directory for project-level config (.browser-devtools-mcp/). Default: process.cwd().SEARCH_STRATEGYSearch strategy: SIMPLE (default, minisearch + stemmer) or FTS5 (better-sqlite3, optional dep).SCENARIO_SEARCH_STRATEGYOverride SEARCH_STRATEGY for scenario search only.
Pricing
Open source
Browser Devtools MCP FAQ
Is Browser Devtools MCP free?
Yes. Browser Devtools MCP is open source, so you can use and self-host it for free.
How do I add Browser Devtools MCP to Claude Code?
Run this command in your terminal: claude mcp add browser-devtools-mcp --env OTEL_EXPORTER_HTTP_HEADERS='<OTEL_EXPORTER_HTTP_HEADERS>' --env FIGMA_ACCESS_TOKEN='<FIGMA_ACCESS_TOKEN>' -- npx -y browser-devtools-mcp
What are the best alternatives to Browser Devtools MCP?
The closest alternatives to Browser Devtools MCP are Browser Use, Scrapling MCP Server, Oya Browser, Mantis and Auto-building agents.
Alternatives to Browser Devtools MCP

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation
Mantis
MCP serverBrowser MCP server that gives agents numbered text pages instead of screenshots
Runs locally- 1 tool
- Open source
- 5 Hacker News points
- Browser automation

Auto-building agents
MCP serverBuild and continue browser and Mac automation scripts for Super through Claude
- Remote
- Paid
- Browser automation

pour
MCP serverRun WCAG 2.2 accessibility audits and vision simulations on any URL from an agent
Runs locally- Open source
- Developer tools