chrome-devtools-mcp

1.9.0 (2026-09-08)

🎉 Features

• Add --allow-unrestricted-paths by default for CLI (#2618) (2dc104c)
• add Agent Plugins 1.0 package (#2623) (05d9e55)
• add an option to turn off js execution tools (#2627) (a78566e)
• Add cookie-debugging skill and improve network/pages tool descriptions (#2596) (6a67552)
• add screencast fps option (#2312) (2e641d8)
• extend --no-javascript-evaluation to cover navigations and initScripts (#2638) (4993a0f)
• option to disable source maps (#2628) (4430a76)
• performance: set default trace buffer size to match DevTools (1.2gb) (#2614) (d1baa90)
• support configurable filesystem roots (#2605) (d00e6f8)

🛠️ Fixes

• detect scheduled script navigations (#2622) (1b2c0e5)
• do not enable the DevTools frontend Audits subscription (#2625) (d1e73ff)
• filter out Chrome webui targets by default (#2648) (020c048)
• honor background when new_page uses isolatedContext (#2658) (f215c82)
• memory: expliclity mention the need of a flag (#2620) (46c3e05)
• truncate long urls in concise network request output (#2513) (552c870)
• validate viewport and geolocation inputs in emulate tool (#2663) (808aed6), closes #2662

📄 Documentation

• correct what --screenshotFormat reduces (#2617) (c575777)
• split the docs in separate files (#2600) (5463101)
• update agents.md for testing (#2660) (18ca912)
• update SECURITY.md (#2626) (fd67970)

🏗️ Refactor

• extract browser options (#2654) (a918b7b)
• extract category config into a seprate file (#2652) (401a119)
• move transform logic to Clearcut level (#2637) (f0058d5)
• wrap Server into a class (#2633) (1a092ff)

1.8.0 (2026-08-25)

🎉 Features

• Add additional params to get_heapsnapshot_edges (#2561) (b58c613)
• add optional stack traces to list_console_messages (#2505) (85c73a0)
• add PWA automation tools (#2430) (0ea5c8d), closes #2270
• Add query_heapsnapshot MCP tool (#2553) (fadbf41)
• allow evaluate_script to skip the stable DOM wait (#2346) (781e2fb)
• make pageId required for page-scoped tools by default (#1777) (50a16fa)
• Report memory kept alive by contexts in get_heapsnapshot_summary (#2570) (4103808)
• Show self and retained sizes for edges (#2529) (2a7eb76)
• support uploading multiple files with upload_file (#2257) (c8a2393)
• Use ranges with human readable sizes (#2589) (61e312f)

🛠️ Fixes

• cli: adjust chrome-devtools start defaults (#2597) (c6cff23)
• cli: enable tools which require --memoryDebugging on the CLI (#2585) (1c92ba0)
• clI: print the errror message alone instead of JSON in the CLI (#2580) (fce756a)
• cli: update the CLI skill (#2569) (0e108ea)
• do not append page url when the previously selected page is gone. (#2588) (6506425)
• do not block tool calls on a roots/list the client is slow to answer (#2477) (d93e667), closes #2476
• do not enable invalidation tracking in performance traces (#2500) (f00778d), closes #2499
• do not validate local files for remote browsers (#2573) (c0a7417)
• ensure debugger statements are skipped by devtools (#2555) (f8572f0)
• fix formatter bugs (#2552) (b247315)
• flakiness in wait for helper (#2541) (12f989a)
• input: select empty-value options by text (#2501) (b969c45)
• new flags for page id routing moved to the end of metrics json (#2613) (6dba5c7)
• puppeteer actions would not follow symlinks anymore (#2592) (1bac85c)
• require .heapsnapshot (or .heaptimeline) as file extension (#2579) (b750168)
• respect screenshot bounds on HiDPI displays (#2536) (ebf58f2)
• warn on unknown CLI args (#2577) (e450369)

📄 Documentation

• add Bob MCP client configuration (#2364) (5c16940)
• fix commands (#2546) (9331b63)

🏗️ Refactor

• make validatePath return resolved url (#2572) (57adfa9)
• move config files out of bin (#2578) (5d02839)
• move files to folders that better represent their use (#2564) (06b7a5c)
• performance: use default trace categories from DevTools (#2571) (cb89762)
• replace debug with NodeJS native (#2562) (f44f3c6)

1.7.0 (2026-08-10)

🎉 Features

• add a utility function to check for localhost. (#2454) (c5ebf9e)
• Add get_heapsnapshot_object_details MCP tool (#2374) (8432cb9)
• Emit native contexts in snapshot summary (#2375) (f78a911)
• Filter heap snapshot objects by native context (#2377) (76fd242)
• telemetry: log devtools data. (#2460) (df2c753)
• telemetry: log is_devtools_open with each tool call. (#2445) (6f60eab)
• telemetry: report whether tool call is made on localhost. (#2455) (6398b7e)
• update lighthouse to 13.4.1 (#2398) (745ffe7)

🛠️ Fixes

• bound per-navigation network request retention (#2435) (b08c73c)
• cli: validate session ids (#2475) (5ca9121)
• cli: warn about version mismatch between cli and daemon (#2461) (3afc44d)
• daemon: preserve hyphenated browser flags in arg serialization and lazy daemon startup (#2405) (d79f3ba)
• dispose heap snapshot workers on context teardown (#2428) (f245c76)
• do not throw synchronously when a CDP session is gone (#2466) (ba4fe3e)
• don't throw if Dialog was handled (#2437) (574c320)
• downscale viewport screenshots when no viewport is emulated (#2380) (39c4140)
• improve daemon lifecycle (#2360) (3ee6a27)
• improve file writing (#2447) (1da4bb0)
• include the tab id in get_tab_id's text response (#2381) (dcbaf49)
• memory: dispose the heap-snapshot worker when loading fails (#2449) (744738d)
• performance: reset trace-running flag when start_trace setup fails (#2420) (40240c0)
• regression after the #2443 (#2462) (4c80ce4)
• rename maxRetainedSize column (#2402) (75c7048)
• screenshot: dispose element handle after take_screenshot (#2422) (fffb40e)
• toggle lazy loading for source maps. (#2486) (8028bfe)
• wait: avoid 180s mutex stall when a dialog opens during an action (#2427) (b4e8f74)

📄 Documentation

• Add devin cli install instruction to README (#2361) (45262c0)
• correct the user data directory documentation (#2473) (5ddbffd)
• skills: update memory leak debugging skill to use native MCP tools (#2436) (99bd90a)
• Update Chrome requirement for categoryExperimentalWebmcp (#2163) (354458e)
• update security.md (#2362) (5012b07)

🏗️ Refactor

• clean up McpResponse.handle (#2392) (348975d)
• introduce Explicit resouce managent (using) (#2443) (5b25370)
• move tool groups (#2365) (2d944f9)
• re-use Puppteer Mutex (#2444) (775ea2d)
• rename methods for clarity (#2442) (dc23bcd)
• use a destructor to shorten the calls (#2376) (77e1d3f)

1.6.0 (2026-07-14)

🎉 Features

• add experimentalGcfFormat flag for GCF-encoded tool responses (#2235) (3d21389)
• Print object count and total sizes in get_heapsnapshot_details (#2325) (15a6b78)
• support --allow-unrestricted-paths configuration (#2296) (6e56c02)
• Support filter with heap snapshots aggregates (#2323) (2812902)
• update Lighthouse to 13.4.0 (#2317) (ffc6060)

🛠️ Fixes

• enforce .gz instead of json.gz in performance tools (#2305) (b06e39b)
• keep a still-open selected page instead of falling back to the first page (#2328) (c645eee), closes #2304
• keep page ids unique across browser reconnects (#2345) (3e8d922)
• paginate page 0 in list_network_requests and list_console_messages (#2359) (d0025b3)
• release held modifiers when press_key key event fails (#2347) (78ccb19)
• report when the selected page was auto-replaced by the fallback (#2308) (2c16ac3), closes #2304
• resolve page ids only among listed pages (#2332) (eb04951), closes #2304
• snapshot: resolve element ids on the correct snapshot (#2295) (b703f2c)
• telemetry: resolve enum values through nested schema wrappers (#2315) (c065fd9)
• Wait until daemon is started (#2327) (ed7e95d)

📄 Documentation

• add Grok Build CLI configuration section (#2294) (aa4be07)
• update memory leak debugging skill (#2330) (c1736a0)

⚡ Performance

• concurrent I/O in Root Path Resolution (#2279) (b2c63e6)

🏗️ Refactor

• clean up McpContext getters (#2340) (5b33deb)
• clean up more of the context interface (#2335) (9cd734b)
• clean up page management (#2333) (16db01f)
• clean up page snapshot generation (#2348) (68cfce2)
• make collectors work per page (#2324) (9bc61b4)
• move and rename files (#2355) (9c3542b)
• move DevTools universe to McpPage (#2341) (c006c9b)
• move remaining McpContext getters (#2342) (58ba174)
• remove isolated context getter (#2336) (8a4ddb3)
• Use array instead of Map for idToClassKey (#2321) (ff53b7b)
• use helper for Dialog handle (#2334) (64005f9)
• use response page in formatting (#2349) (c53c1ec)

1.5.0 (2026-07-03)

🎉 Features

• Add get_heapsnapshot_duplicate_strings MCP tool (#2280) (67a56c0)
• Add MCP tools for heap snapshot comparison (#2198) (5d7b656)

🛠️ Fixes

• cli: improve error messages to guide AI agents and developers (#2161) (cf00305)
• create PID directory with secure permissions (0o700) (#2262) (7fa95d3)
• respecte allow/block list in loadResouce (#2254) (6a94663)
• validate extension-enforced output paths (#2269) (a922814)

📄 Documentation

• fix Antigravity config -y flag before npx positional args (#2272) (604b38f)
• fix formatting and indentation of tool descriptions (#2275) (8d8cf12)

⚡ Performance

• use concurrent reads for loadIssueDescriptions (#2249) (d144965)

🏗️ Refactor

• Merge MCP tools for comparing heap snapshots (#2281) (3f4a49a)

1.4.0 (2026-06-23)

🎉 Features

• publish the skills folder (#2229) (5367f7e)

🛠️ Fixes

• hide Windows update check consoles (#2231) (6225ffb)
• network: keep redirect chain order consistent between text and JSON (#2221) (5a9d6af)

📄 Documentation

• fix showing defaults in configuration (#2234) (38dd346)
• readme: explicitly call out that CD4A can power your browser agent (#2227) (705d0e1)
• update security.md (#2248) (e559765)

1.3.0 (2026-06-18)

🎉 Features

• Add get_heapsnapshot_dominators MCP tool (#2215) (08c234e)
• Add retaining paths MCP tool (#2187) (a97c642)
• Add the get_heapsnapshot_edges MCP tool (#2180) (4f8eb7a)
• include page title in list_pages output (#2166) (b646feb)
• screenshot: add CLI options to cap screenshot size at the source (#1823) (55c8a54)
• Use HeapSnapshotProxy.nodeIndexById (#2193) (6bd8c91)

🛠️ Fixes

• handle missing third-party tool toolGroup description gracefully (#2224) (8fe398e)
• handle screencast file extensions case-insensitively and clean up temp dir on failure (#2207) (ba80096)
• limit windows test concurrency (#2205) (e77101e)
• Reset toolGroups before gathering toolGroups (#2200) (ed02047)
• return error message when screencast_stop is called with no active recording (#2209) (9e32002)

1.2.0 (2026-06-08)

🎉 Features

• add experimental TOON support for structured content output (#2042) (aa33bff)
• Adds close_heapsnapshot MCP tool (#2174) (8713b93)
• Handle multiple providers of third-party developer tools (#2168) (30d59a7)
• implement extension service worker logs (#1915) (29e3898)
• memory debugging tools (#2169) (0217397)
• support allowedUrlPattern & blockedUrlPattern Options (#2037) (02b4492)

🛠️ Fixes

• Cursor plugin homepage setting field (#2173) (8971890)

📄 Documentation

• skill: guide agent to prompt for --categoryExtensions (#2189) (8b458f7)

⚡ Performance

• lighthouse file saves to run concurrently (#2178) (f90f863)

🏗️ Refactor

• change type of logger (#2165) (bf0574d)
• use validate files on the tool level (#2152) (2e039c0), closes #2150

1.1.1 (2026-05-27)

🛠️ Fixes

• cli: have pageId as first argument (#2142) (60be3e6)

1.1.0 (2026-05-26)

🎉 Features

• add extraHttpHeaders emulation to emulate tool (#1176) (6992106)
• created cursor plugin.json setting file with release auto versioning (#2091) (10c8205)

🛠️ Fixes

• Apply CPU throttling to secondary CDP session (#2092) (3ade962)
• cli: address pid file creation issues (#2124) (1b51a52)
• exit on stdin EOF and SIGTERM/SIGINT/SIGHUP, closing the browser cleanly (#2117) (43b934c)
• Fix throttling info in performance trace output (#2096) (57f32b0)
• make pageId required (#2084) (d751693), closes #2052
• remove duplicate .mcp.json (#2095) (dbf6ba9)
• Set viewport after updating timeouts when setting emulation (#2134) (0c3ac37)
• use pinned version for plugins (#2135) (8ea5f09)
• use realpath for MCP roots validation (#2127) (176eb69)

📄 Documentation

• align coding agent examples with Antigravity (#2094) (ce31594)
• fix installation instructions for VS Code (#2087) (9f47df3)

🏗️ Refactor

• remove redundant validatePath calls (#2136) (521c388)

1.0.1 (2026-05-18)

🛠️ Fixes

• include saved image paths in CLI JSON output (#2070) (a9fb555)

📄 Documentation

• add version to the LTS (#2080) (a2083a2)

1.0.0 (2026-05-18)

🎉 Features

• report new URL after actions that trigger navigation (#1853) (b594858)
• support filePath in evaluate_script (#2054) (90d368d)

🛠️ Fixes

• disable NetworkManager in DevTools (#1834) (d0e6539)
• do not use getSelectedMcpPage (85f935b)
• improve geolocation emulation (#2036) (213720b)
• report unknown tool arguments (#2064) (041b208)
• respect user's npm registry configuration in update check (#2038) (83a299f)

📄 Documentation

• explain concurrent session options (#2062) (41944b3)
• fix typo (#2075) (1deb4f8)
• remove windows workaround and document Node LTS support (#2074) (30dcd0b)
• unhide various experimental flags (#2055) (081c903)

🏗️ Refactor

• waitForResult helpers (#2041) (f6a12be)

0.26.0 (2026-05-11)

🎉 Features

• add an error logging method (#2006) (06e0ab6)

🛠️ Fixes

• cli: allow --autoConnect on CLI start (#2015) (9882391), closes #1859 #1184
• Make fill_form more appealing when filling forms with checkboxes (#1971) (407c2bd)
• only require a page in page-scoped tools (#2030) (8e06761)
• telemetry: re-run the update metrics script (#2005) (e9ec375)

📄 Documentation

• Fix Claude Code instructions (#2018) (a5ad67b)

🏗️ Refactor

• extract ToolHandler (#2032) (178b790)