osfeed.dev
Projects/ChromeDevTools / chrome-devtools-mcp

Chrome DevTools for agents

Chrome browser automation and debugging through MCP

Get it on GitHub
Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for chrome-devtools-mcp-v1.10.1 (2026-09-23), so it may lag behind newer releases.

Are you @ChromeDevTools?Claim it, and your coding agent keeps it current with each release
chrome-devtools-mcp-v1.10.1 · 28 things you can do 49 changes to know before upgrading
Follow GitHub

Automate Chrome, inspect web pages and network traffic, and diagnose performance and memory problems from a coding agent.

What you can do with Chrome DevTools for agents

Click, fill forms, drag elements, handle dialogs and upload files in Chrome.

Present at chrome-devtools-mcp-v0.6.1
Good to know

Requires access to the controlled Chrome instance.

Open, select, close and navigate Chrome tabs.

Present at chrome-devtools-mcp-v0.6.1
Good to know

The final open page cannot be closed.

Test pages with CPU throttling, network throttling and different viewport sizes.

Present at chrome-devtools-mcp-v0.6.1
Good to know

Emulation affects the controlled browser page.

Record browser performance traces and inspect performance insights.

Present at chrome-devtools-mcp-v0.6.1
Good to know

Trace collection requires a running Chrome page.

List browser network requests and inspect request details.

Present at chrome-devtools-mcp-v0.6.1
Good to know

History covers up to three navigations and 1,000 requests per navigation.

Inspect browser console messages to diagnose page errors.

Present at chrome-devtools-mcp-v0.6.1
Good to know

Up to three navigations are retained, with 10,000 console messages per navigation.

Capture screenshots and accessibility-tree snapshots of web pages.

Present at chrome-devtools-mcp-v0.6.1
Good to know

Snapshots expose page content to the connected MCP client.

Evaluate JavaScript functions in a browser page.

Present at chrome-devtools-mcp-v0.6.1
Good to know

Returned values must be JSON-serializable.

Show all 28

Launch a dedicated Chrome instance or connect to a running debuggable browser.

Present at chrome-devtools-mcp-v0.6.1
Good to know

Auto-connect requires locally running Chrome 144+, remote debugging enabled and user approval.

Limit the tools exposed to an MCP client by category.

Since chrome-devtools-mcp-v0.9.0
Good to know

Category flags control emulation, performance and network tools.

Save a JavaScript heap snapshot for memory investigation.

Since chrome-devtools-mcp-v0.18.1
Good to know

Requires a Chrome page and a local output path.

Navigate, evaluate scripts and take screenshots with a three-tool browser interface.

Since chrome-devtools-mcp-v0.18.1
Good to know

`--slim` exposes only navigation, script execution and screenshots.

Test separate browser sessions with isolated cookies and storage.

Since chrome-devtools-mcp-v0.18.1
Good to know

Pages with the same named browser context share storage; different contexts are isolated.

Run Lighthouse audits for accessibility, best practices and SEO.

Since chrome-devtools-mcp-v0.20.3
Good to know

Runs against a browser page; use performance tracing for performance investigation.

Install, list, reload, trigger and uninstall unpacked Chrome extensions.

Since chrome-devtools-mcp-v0.23.0
Good to know

Enable `--category-extensions`; documentation requires a pipe connection rather than auto-connect, browser URL or WebSocket.

Allow or block browser requests using URL patterns.

Since chrome-devtools-mcp-v1.2.0
Good to know

`--allowed-url-pattern` requires Chrome 149+; patterns apply to browser traffic, including navigation and subresources.

Install, launch, uninstall and inspect OS integration state for Progressive Web Apps.

Since chrome-devtools-mcp-v1.8.0
Good to know

Enable `--category-pwa`; requires a pipe connection. Installs default to browser mode unless standalone is requested.

Choose allowed filesystem directories for browser tools.

Since chrome-devtools-mcp-v1.9.0
Good to know

Use repeatable `--filesystem-root` or `--workspace`; the default root is the OS temp directory.

Disable JavaScript evaluation tools and script-based navigation in browser automation.

Since chrome-devtools-mcp-v1.9.0
Good to know

`--no-javascript-evaluation` disables evaluation and init scripts and rejects javascript, data and vbscript URL navigation.

Inspect matched CSS rules and cascade information for a page element.

Since chrome-devtools-mcp-v1.10.1
Good to know

Requires an element UID from `take_snapshot`; returns 10 rules per page by default.

Load browser-tool settings from a JSON configuration file.

Since chrome-devtools-mcp-v1.10.1
Good to know

Pass the file path with `--config`.

Record a screencast of a Chrome page.

ExperimentalSince chrome-devtools-mcp-v0.18.1
Good to know

Experimental; requires `--experimental-screencast` and ffmpeg on the server PATH.

Automate and inspect Chrome from the command line without an MCP client.

ExperimentalSince chrome-devtools-mcp-v0.20.3
Good to know

Experimental `chrome-devtools` CLI; requires the npm package and Chrome.

Route browser actions to explicit page IDs for concurrent sessions.

ExperimentalSince chrome-devtools-mcp-v0.20.3
Good to know

Page-scoped calls require `pageId` by default; disable routing to use the selected page.

List and execute WebMCP tools exposed by a page.

ExperimentalSince chrome-devtools-mcp-v0.23.0
Good to know

Requires `--category-experimental-webmcp`, Chrome 150+ and `--enable-features=WebMCP`.

Click a browser page at screen coordinates.

ExperimentalSince chrome-devtools-mcp-v0.23.0
Good to know

Experimental; enable `--experimental-vision`. Coordinate accuracy depends on the calling model.

List and execute third-party developer tools exposed by a page.

ExperimentalSince chrome-devtools-mcp-v1.0.1
Good to know

Experimental; enable `--category-experimental-third-party`; the inspected page must expose tools.

Inspect heap statistics, class instances and retainers to investigate memory use.

ExperimentalSince chrome-devtools-mcp-v1.0.1
Good to know

Requires `--memory-debugging` and heap snapshot files.

Before you upgrade Chrome DevTools for agents

Newest first
Show 46 older

Use viewport strings such as `800x600x2,mobile,touch` and geolocation as `latitudexlongitude`; omit network settings to clear throttling instead of using `No emulation`.

Action requiredInferredAffects: Clients passing object-valued emulation settings or No emulation.
Read the evidence
Chrome DevTools for agents release history 21
chrome-devtools-mcp-v1.10.1
with chrome-devtools-mcp-v1.10.0

Inspect which CSS rules apply to an element and why.

Details

`get_css_styles` returns matched, inline and inherited rules with cascade information; JSON configuration files are supported.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Added: Inspect matched CSS rules and cascade information f…Added: Load browser-tool settings from a JSON configuratio…Behavior changed / inferred: Inspect browser console messages to diagnose page e…Now works: Automate and inspect Chrome from the command line w…Now works: Click, fill forms, drag elements, handle dialogs an…Now works: Run Lighthouse audits for accessibility, best pract…Behavior changed

Seeded by @iluxav with Codex

Read the evidence

Choose which directories browser tools may access.

Details

Explicit filesystem roots and JavaScript restrictions are added; the CLI allows unrestricted paths by default.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Added: Choose allowed filesystem directories for browser t…Added: Disable JavaScript evaluation tools and script-base…Behavior changed: Automate and inspect Chrome from the command line w…Improved: Record a screencast of a Chrome page.Improved: Inspect browser console messages to diagnose page e…Behavior changed: Record browser performance traces and inspect perfo…Behavior changed: Open, select, close and navigate Chrome tabs.Action required: Test pages with CPU throttling, network throttling…Now works: Test separate browser sessions with isolated cookie…

Seeded by @iluxav with Codex

Read the evidence

Install and launch Progressive Web Apps for browser testing.

Details

PWA tools and heap queries are added; page IDs become required by default and uploads switch to an array of paths.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Added: Install, launch, uninstall and inspect OS integrati…Action required: Route browser actions to explicit page IDs for conc…Action required / inferred: Click, fill forms, drag elements, handle dialogs an…Improved: Inspect heap statistics, class instances and retain…Action requiredImproved: Inspect browser console messages to diagnose page e…Improved: Evaluate JavaScript functions in a browser page.Now works: Capture screenshots and accessibility-tree snapshot…Behavior changed / inferred: Automate and inspect Chrome from the command line w…Action required / inferred

Seeded by @iluxav with Codex

Read the evidence

Inspect heap objects by native context to investigate memory retention.

Details

Heap summaries expose native contexts and object details; network retention and CLI session validation introduce limits.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Improved: Inspect heap statistics, class instances and retain…Behavior changed / inferred: List browser network requests and inspect request d…Action required / inferred: Automate and inspect Chrome from the command line w…Action required: List and execute WebMCP tools exposed by a page.Now works: Click, fill forms, drag elements, handle dialogs an…Now works: Capture screenshots and accessibility-tree snapshot…

Seeded by @iluxav with Codex

Read the evidence

Keep browser page IDs distinct across reconnections.

Details

Page routing and first-page pagination are corrected; file-writing tools now restrict clients without roots to temporary storage.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Now works: Route browser actions to explicit page IDs for conc…Now works: Open, select, close and navigate Chrome tabs.Now works: List browser network requests and inspect request d…Now works: Inspect browser console messages to diagnose page e…Improved: Inspect heap statistics, class instances and retain…Action requiredAction required / inferredBehavior changed / inferred: Record browser performance traces and inspect perfo…Now works: Click, fill forms, drag elements, handle dialogs an…Now works: Capture screenshots and accessibility-tree snapshot…

Seeded by @iluxav with Codex

Read the evidence

Compare heap snapshots to investigate growing memory use.

Details

`compare_heapsnapshots` compares class totals or a selected class; duplicate strings can be listed.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Improved: Inspect heap statistics, class instances and retain…Now works: Allow or block browser requests using URL patterns.

Seeded by @iluxav with Codex

Read the evidence
chrome-devtools-mcp-v1.4.0
with chrome-devtools-mcp-v1.3.0

Find which objects keep a heap object alive.

Details

Heap inspection adds dominators, outgoing edges and retaining paths; screenshot dimensions and encoding can be configured.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Improved: Inspect heap statistics, class instances and retain…Improved: Capture screenshots and accessibility-tree snapshot…Behavior changed: Open, select, close and navigate Chrome tabs.Now works: List browser network requests and inspect request d…Action required / inferred: List and execute WebMCP tools exposed by a page.

Seeded by @iluxav with Codex

Read the evidence

Restrict the browser to selected URL patterns during automation.

Details

Allow/block URL patterns constrain browser requests; memory inspection and extension service-worker logs are available.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Added: Allow or block browser requests using URL patterns.Improved: Install, list, reload, trigger and uninstall unpack…Improved: Inspect heap statistics, class instances and retain…Improved: List and execute third-party developer tools expose…

Seeded by @iluxav with Codex

Read the evidence
chrome-devtools-mcp-v1.1.1
with chrome-devtools-mcp-v1.1.0

Send additional HTTP headers while testing a browser page.

Details

Emulation adds `extraHttpHeaders`; heap tool names and page-routing call requirements change.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Improved: Test pages with CPU throttling, network throttling…Action required / inferred: Route browser actions to explicit page IDs for conc…Action required / inferred: Save a JavaScript heap snapshot for memory investig…Action required / inferred: Inspect heap statistics, class instances and retain…Behavior changed: Launch a dedicated Chrome instance or connect to a…

Seeded by @iluxav with Codex

Read the evidence
chrome-devtools-mcp-v1.0.1
with chrome-devtools-mcp-v0.24.0, chrome-devtools-mcp-v0.25.0, chrome-devtools-mcp-v0.26.0, chrome-devtools-mcp-v1.0.0

Inspect developer tools exposed by the page itself.

Details

Third-party page tools and Lighthouse agentic-browsing checks are added; filesystem access now honors MCP client roots.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Added: List and execute third-party developer tools expose…Added / inferred: Inspect heap statistics, class instances and retain…Improved: Run Lighthouse audits for accessibility, best pract…Action required / inferredAction required / inferred: List and execute WebMCP tools exposed by a page.Behavior changed: Inspect browser console messages to diagnose page e…Now works: Click, fill forms, drag elements, handle dialogs an…Improved: Evaluate JavaScript functions in a browser page.Now works: Automate and inspect Chrome from the command line w…Behavior changed: Open, select, close and navigate Chrome tabs.Action required / inferred: Test pages with CPU throttling, network throttling…Behavior changed

Seeded by @iluxav with Codex

Read the evidence
chrome-devtools-mcp-v0.23.0
with chrome-devtools-mcp-v0.22.0

Install and exercise unpacked Chrome extensions during testing.

Details

Extension debugging, coordinate clicks and WebMCP tools become available behind flags; screencasts gain WebM output.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Added: Install, list, reload, trigger and uninstall unpack…Added: List and execute WebMCP tools exposed by a page.Added: Click a browser page at screen coordinates.Improved: Record a screencast of a Chrome page.Improved: List browser network requests and inspect request d…Behavior changed: Evaluate JavaScript functions in a browser page.Behavior changedBehavior changed / inferred

Seeded by @iluxav with Codex

Read the evidence

List browser tabs after the selected tab has closed.

Details

`list_pages` recovers from a closed selected page; CLI profile handling respects a supplied data directory.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Now works: Open, select, close and navigate Chrome tabs.Now works: Automate and inspect Chrome from the command line w…Behavior changed / inferred: Run Lighthouse audits for accessibility, best pract…Behavior changed / inferred: Save a JavaScript heap snapshot for memory investig…

Seeded by @iluxav with Codex

Read the evidence
chrome-devtools-mcp-v0.20.3
with chrome-devtools-mcp-v0.19.0, chrome-devtools-mcp-v0.20.0, chrome-devtools-mcp-v0.20.1, chrome-devtools-mcp-v0.20.2

Audit a web page with Lighthouse from your browser tooling.

Details

Lighthouse audits and an experimental `chrome-devtools` CLI are introduced; emulation parameters change format.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Added: Run Lighthouse audits for accessibility, best pract…Added: Automate and inspect Chrome from the command line w…Added: Route browser actions to explicit page IDs for conc…Action required / inferred: Test pages with CPU throttling, network throttling…Behavior changed / inferred: Record browser performance traces and inspect perfo…Action required

Seeded by @iluxav with Codex

Read the evidence
chrome-devtools-mcp-v0.18.1
with chrome-devtools-mcp-v0.14.0, chrome-devtools-mcp-v0.15.0, chrome-devtools-mcp-v0.15.1, chrome-devtools-mcp-v0.16.0, chrome-devtools-mcp-v0.17.0, chrome-devtools-mcp-v0.17.1, chrome-devtools-mcp-v0.17.2, chrome-devtools-mcp-v0.17.3, chrome-devtools-mcp-v0.18.0

Record a video of a browser session for debugging.

Details

The grouped releases add screencasts, heap snapshots, slim mode, isolated contexts and richer emulation; usage statistics and CrUX become enabled by default.

Also: Also adds memory snapshots, isolated sessions, slim mode and source-mapped errors.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Added: Record a screencast of a Chrome page.Added: Save a JavaScript heap snapshot for memory investig…Added: Navigate, evaluate scripts and take screenshots wit…Added: Test separate browser sessions with isolated cookie…Improved: Test pages with CPU throttling, network throttling…Improved: Evaluate JavaScript functions in a browser page.Improved: Inspect browser console messages to diagnose page e…Improved: List browser network requests and inspect request d…Behavior changed / inferred: Click, fill forms, drag elements, handle dialogs an…Action required / inferred: Open, select, close and navigate Chrome tabs.Behavior changed: Record browser performance traces and inspect perfo…Behavior changedBehavior changed: Launch a dedicated Chrome instance or connect to a…

Seeded by @iluxav with Codex

Read the evidence

Save a performance trace for later inspection.

Details

Performance tools accept `filePath`; page selection and closing switch from indexes to IDs.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Improved: Record browser performance traces and inspect perfo…Action required / inferred: Open, select, close and navigate Chrome tabs.Improved: Launch a dedicated Chrome instance or connect to a…Now works: Test pages with CPU throttling, network throttling…

Seeded by @iluxav with Codex

Read the evidence
chrome-devtools-mcp-v0.12.1
with chrome-devtools-mcp-v0.11.0, chrome-devtools-mcp-v0.12.0

Connect your agent to an already running Chrome profile.

Details

`--auto-connect` reuses a running browser; `--user-data-dir` selects a profile directory.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Improved: Launch a dedicated Chrome instance or connect to a…Improved: Test pages with CPU throttling, network throttling…Behavior changed: Inspect browser console messages to diagnose page e…Improved: Open, select, close and navigate Chrome tabs.

Seeded by @iluxav with Codex

Read the evidence

Read console messages without DevTools issue entries.

Details

DevTools issues are temporarily excluded from `list_console_messages`.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Behavior changed: Inspect browser console messages to diagnose page e…

Seeded by @iluxav with Codex

Read the evidence
chrome-devtools-mcp-v0.10.1
with chrome-devtools-mcp-v0.10.0

Use keyboard shortcuts while automating a browser page.

Details

The new `press_key` tool handles key combinations; navigation and emulation tool names are consolidated.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Improved: Click, fill forms, drag elements, handle dialogs an…Action required / inferred: Open, select, close and navigate Chrome tabs.Action required / inferred: Test pages with CPU throttling, network throttling…Action required / inferred: Record browser performance traces and inspect perfo…Improved: Capture screenshots and accessibility-tree snapshot…Improved: List browser network requests and inspect request d…

Seeded by @iluxav with Codex

Read the evidence

Inspect console messages retained across recent page navigations.

Details

Console tools add filtering, pagination and per-message details; network requests use stable IDs.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Improved: Inspect browser console messages to diagnose page e…Action required / inferred: List browser network requests and inspect request d…Improved: Launch a dedicated Chrome instance or connect to a…Improved: Capture screenshots and accessibility-tree snapshot…Now works: Evaluate JavaScript functions in a browser page.Added: Limit the tools exposed to an MCP client by categor…

Seeded by @iluxav with Codex

Read the evidence
chrome-devtools-mcp-v0.8.1
with chrome-devtools-mcp-v0.7.0, chrome-devtools-mcp-v0.7.1, chrome-devtools-mcp-v0.8.0

Inspect HTTP request and response bodies from the browser.

Details

Offline network emulation and request/response bodies are available; Chrome launch arguments can be supplied.

Install [email protected] from npm; requires Node.js and Chrome. Optional tools may require flags.

Improved: Test pages with CPU throttling, network throttling…Improved: List browser network requests and inspect request d…Improved: Launch a dedicated Chrome instance or connect to a…Now works: Click, fill forms, drag elements, handle dialogs an…Improved: Capture screenshots and accessibility-tree snapshot…

Seeded by @iluxav with Codex

Read the evidence
chrome-devtools-mcp-v0.6.1
Starting point

Automate interactions with a live Chrome browser from an MCP client.

Details

Baseline before the 12-month history window: input and tab automation, emulation, traces, network and console inspection, screenshots, snapshots and JavaScript evaluation.

Install [email protected] from npm; requires Node.js 20.19 or supported newer LTS, npm, Chrome and an MCP client.

Added: Click, fill forms, drag elements, handle dialogs an…Added: Open, select, close and navigate Chrome tabs.Added: Test pages with CPU throttling, network throttling…Added: Record browser performance traces and inspect perfo…Added: List browser network requests and inspect request d…Added: Inspect browser console messages to diagnose page e…Added: Capture screenshots and accessibility-tree snapshot…Added: Evaluate JavaScript functions in a browser page.Added: Launch a dedicated Chrome instance or connect to a…

Seeded by @iluxav with Codex

Read the evidence