NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #4836 most downloaded on npm
Playwright Tools for MCP
Latest stable
0.0.85
Last release 13 days ago
09 Nov 2026
Ships fairly regularly
a new release about every 8 days
Nearly every release is documented
notes for 56 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
438 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
🌙 Keep the browser in the background (microsoft/playwright#42973) — connecting through the extension activated the tab and focused the browser window,
--background alongside --extension (config background: true, env PLAYWRIGHT_MCP_BACKGROUND=1) to leave the connected tab inactive and its window unfocused, and to open the client's new tabs in the background. With PLAYWRIGHT_MCP_EXTENSION_TOKEN set, the connect page opens in the background too (Chrome 158.0.8127.2 or later, with the browser already running). Requires extension 0.5.0 or later. Chrome throttles timers and animation frames in background tabs. (microsoft/playwright#43864)--no-tab-group alongside --extension (config tabGroup: false, env PLAYWRIGHT_MCP_NO_TAB_GROUP=1) to keep the selected tab and the tabs the client opens in their existing groups, if any. Connection approval is unchanged, each controlled tab still belongs to one client, and the extension's status page lists the controlled tabs. Requires extension 0.5.0 or later. (microsoft/playwright#43814)browser.contextOptions.locateOnlyVisible: true in the config file to restrict locators to visible elements, both in the target of element tools such as browser_click and in browser_run_code_unsafe, as if .filter({ visible: true }) ended each of them. A locator that ends with its own visibility filter keeps it. Off by default. (microsoft/playwright#43903)browser_snapshot now retains identifying names on containers and table headers when the text supplying the name also appears among their children. (microsoft/playwright#43810)<label> associations were ignored for form-associated custom elements. Element tools now recognize these controls through targets such as getByLabel('City'), and accessible names use the associated labels too. Both for attributes and nested labels are supported. (microsoft/playwright#43900)fix(aria): restore snapshot visibility rules for inert and modal content — the filtering announced in v0.0.84 is reverted: browser_snapshot no longer hides content solely because it is inert or outside a modal dialog. Click, fill and select actions still wait for explicitly inert targets to become non-inert (microsoft/playwright#43792). (microsoft/playwright#43850, microsoft/playwright#43851)fix(mcp): preserve non-JSON evaluation results — browser_evaluate returns readable representations of values such as BigInt, NaN, Infinity, undefined and circular objects instead of losing values or failing JSON serialization. JSON-compatible results keep their existing format (#1838). (microsoft/playwright#43973)fix(mcp): resolve config file paths relative to their source — profile, executable, storage-state, output and other file paths in a config resolve against that file's directory, or its target's directory for a symlink. CLI and environment paths remain relative to the working directory. Extension connections also honor the merged executable-path configuration (#1836). (microsoft/playwright#43970)fix(extension): report lost tab instead of crashing — tool responses report when a page closes before its snapshot can be captured. Extension connections also explain that Chrome may have detached the debugger because of an unsupported frame, rather than crashing response rendering (microsoft/playwright#43230). (microsoft/playwright#43863)fix(mcp): bound settle waits when page timers cannot run — tool calls no longer hang during their settling delay when page timers are throttled, paused or otherwise unable to run (microsoft/playwright#43752). (microsoft/playwright#43767)fix(mcp): report event listener exceptions as console errors — exceptions from page and context listeners installed through browser_run_code_unsafe appear in tool responses and browser_console_messages instead of escaping as unhandled errors (microsoft/playwright#43770). (microsoft/playwright#43686)fix(mcp): validate device names and preserve device descriptors — unknown --device values produce an explicit error, and per-client overrides no longer mutate shared device presets (#1834). (microsoft/playwright#43971)fix(mcp): report one-based console source lines — source locations in browser_console_messages and console entries in tool responses now use editor-style line numbers starting at 1 (#1839). (microsoft/playwright#43975)fix(mcp): clarify screenshot actions with vision tools — the browser_take_screenshot description no longer rules out acting on a screenshot. browser_snapshot stays the default for actions; with --caps=vision, the description points to the coordinate-based mouse tools for elements that the snapshot does not expose, such as canvas content (#1816). (microsoft/playwright#43857)fix(aria): match mixed-case selected options in accessible names — snapshots and role locators include the selected option's text when a custom listbox uses a mixed-case value such as aria-selected="TRUE" (microsoft/playwright#43785). (microsoft/playwright#43787)fix(chromium): preserve fonts when connecting with noDefaults — extension connections no longer overwrite the existing browser's font settings, avoiding unexpected changes to page rendering (microsoft/playwright#43715). (microsoft/playwright#43773)fix(chromium): honor Linux config directories for channel connections — extension profile lookup respects CHROME_USER_DATA_DIR, CHROME_CONFIG_HOME and XDG_CONFIG_HOME. Channel-based --cdp-endpoint connections also use the WebSocket path advertised in DevToolsActivePort (microsoft/playwright#43880). (microsoft/playwright#43884)fix(chromium): preserve HTTP navigations across HTTPS upgrade modes — in browsers launched by the server, browser_navigate keeps HTTP URLs on HTTP instead of Chrome automatically upgrading them to HTTPS (microsoft/playwright#43871). (microsoft/playwright#43877)fix(chromium): account for tabs and toolbar in the new headless mode — with --headless, Chrome and Edge now size their window to fit the viewport below the tab strip and toolbar, so videos from browser_start_video (opt-in via --caps=devtools) no longer lose the bottom of the page. (microsoft/playwright#43904)fix(screenshot): support full-page SVG documents — browser_take_screenshot with fullPage: true works on standalone SVG documents instead of waiting for a nonexistent HTML body (microsoft/playwright#43962). (microsoft/playwright#43972)👥 Separate sessions in one browser — work with multiple accounts without sharing their cookies or storage. browser_tabs with action: "new" now accepts
browser_tabs with action: "new" now accepts isolatedContext: "<name>": tabs with the same name share a context, while different names stay isolated. Omit it or use "default" for the default context. Cookie and storage tools operate on the current tab's context. (microsoft/playwright#43087)--redact-url-params=access_token,code (config redactUrlParams, env PLAYWRIGHT_MCP_REDACT_URL_PARAMS) replaces the named query and fragment parameter values with <redacted> in tool responses. Like secrets, this is a convenience, not a security feature. The extension also removes its connection token from the connect page URL after reading it. (microsoft/playwright#43258)browser_find accepts a positive integer maxResults, returns the first matching items with their context, and reports the total match count. Omit it to keep returning all matches; ancestor paths are unchanged. (microsoft/playwright#42947)browser_network_requests accepts all: true to include retained history, keeping up to 200 requests from earlier navigations. Request indexes stay stable across navigations for browser_network_request. browser_console_messages also reports counts consistent with its existing all option. (microsoft/playwright#43526)browser_click now accept JavaScript, Python, Java and C# locators in target, alongside snapshot refs and CSS selectors. Invalid targets get an actionable error, including a reminder to pass the bare ref rather than button [ref=e5]. (microsoft/playwright#43539)roots/list can stall the first tool call. Pass --ignore-roots (config ignoreRoots: true, env PLAYWRIGHT_MCP_IGNORE_ROOTS=true) to skip that request and use the server's current working directory as the workspace root. (microsoft/playwright#43532)browser_cookie_delete (opt-in via --caps=storage) accepts optional domain and path filters to leave other domains and paths untouched. (microsoft/playwright#43319)fix(mcp): allow combining time, text and textGone in browser_wait_for — when combined with a text condition, time is its timeout (capped at 30 seconds), not a delay before checking it. Supplying both text and textGone now waits for the first condition to happen, rather than both in sequence. (microsoft/playwright#43011)fix(mcp): allow loopback hosts by default for all bind addresses — HTTP clients can connect through localhost, 127.0.0.1 or [::1] regardless of the bind address. Other hosts still require --allowed-hosts; binding to 0.0.0.0 prints a usable localhost URL. (microsoft/playwright#42993)fix(mcp): pass credentials from --proxy-server as proxy username/password — credentials embedded in the proxy URL are now passed to the browser as proxy authentication settings. (microsoft/playwright#43071)fix(mcp): race browser_navigate_back against modal states — browser_navigate_back reports a dialog opened during history navigation instead of timing out. (microsoft/playwright#43252)fix(mcp): normalize bare host URLs and loopback IP addresses — browser_navigate handles scheme-less hosts with ports and uses HTTP for loopback addresses such as 127.0.0.1:3000 and [::1]:3000. (microsoft/playwright#43264)fix(mcp): do not close the browser twice when the client disconnects — stdio disconnects let the browser close gracefully instead of force-killing it through a second close request. Dashboard annotation processes also exit when their parent goes away. (microsoft/playwright#43174)fix(mcp): give each isolated client its own idle timer — with HTTP transport and --isolated, an idle client's context now expires even while another client keeps the shared browser busy. (microsoft/playwright#43527)fix(mcp): apply route headers without bypassing origin filters — browser_route (opt-in via --caps=network) matches added request header names case-insensitively, includes custom headers in mocked responses, and preserves origin filters and other routes when modifying request headers. (microsoft/playwright#43227, microsoft/playwright#43244, microsoft/playwright#43637)fix(mcp): correct cookie filtering and missing-domain errors — browser_cookie_list (opt-in via --caps=storage) matches domain and path boundaries instead of unrelated names such as notexample.com or /apiary. browser_cookie_set asks for an explicit domain when the current page has no hostname, such as about:blank. (microsoft/playwright#43316, microsoft/playwright#43368, microsoft/playwright#43318)fix(mcp): accept Windows paths in browser_resume location — browser_resume (opt-in via --caps=devtools) no longer mistakes a Windows drive-letter colon for the line-number separator. (microsoft/playwright#43349)fix(mcp): report run-code route handler exceptions once and verbatim — browser_run_code_unsafe reports a route handler's thrown value without duplicating it or wrapping non-Error values in another error. (microsoft/playwright#43203)fix(extension): release debugger when attach completes after connection close — disconnecting while browser_tabs attaches to a new tab no longer leaves that tab attached to the extension's debugger. (microsoft/playwright#43025)fix(chromium): close pages that crashed before connecting over CDP — connecting through --cdp-endpoint no longer stalls on an already crashed or discarded page; those pages are omitted from the tab list. (microsoft/playwright#43075)fix(aria): skip text nodes that are not rendered — browser_snapshot and accessible names omit unrendered text, including unslotted shadow-host text and text directly inside closed <details>. (microsoft/playwright#43150)fix(a11y): treat inert elements and content outside of modal dialogs as hidden — snapshots exclude inert content and content outside the topmost modal <dialog>. Click and fill actions wait for targets to stop being inert instead of silently misfiring. (microsoft/playwright#43211)fix(aria): do not count whitespace-only contributors as name sources — snapshots retain button names when whitespace around a hidden icon previously caused the name to disappear. (microsoft/playwright#43317)fix(aria): resolve label references consistently — snapshots and role locators recognize tab- or newline-separated label IDs and labels assigned through ariaLabelledByElements, while retaining attribute-based labels in older browsers. (microsoft/playwright#43361, microsoft/playwright#43577, microsoft/playwright#43722)fix(aria): quote ~, .inf and .nan in aria snapshots — YAML-like names remain strings rather than being parsed as null or special floating-point values. (microsoft/playwright#43469)fix(aria): preserve iframe snapshots with fallback text — snapshots retain an iframe's contents when the iframe element also contains fallback text. (microsoft/playwright#43635)fix(aria): match mixed-case roles and states — snapshots and role locators recognize mixed-case role and ARIA state values, including checked, pressed and expanded states. (microsoft/playwright#43727)Configs that use @playwright/mcp@latest pick this release up on the next client restart. To pin it:
npx @playwright/mcp@0.0.84
browser_find takes filename to save matches to a file instead of the response (microsoft/playwright#42077). (microsoft/playwright#42968)
browser_find takes filename to save matches to a file instead of the response (microsoft/playwright#42077). (microsoft/playwright#42968)browser_navigate and browser_reload report a dialog opened during page load instead of timing out (microsoft/playwright#42817). (microsoft/playwright#42908)browser_wait_for reports when time is capped at 30 seconds (#1767). (microsoft/playwright#42932)"/home/" (microsoft/playwright#42807). (microsoft/playwright#42811)browser_find results to a file — new filename parameterbrowser_navigate and browser_reload report a dialog opened duringbrowser_wait_for reports when time is capped at 30 seconds"/home/"🎬 Smooth 60 fps, styleable videos — browser_start_video (opt-in via --caps=devtools) takes fps, so fps: 60 records smooth 60 fps videos instead of the
browser_start_video (opt-in via --caps=devtools) takes fps, so fps: 60 records smooth 60 fps videos instead of the default 25, and cursor: true renders an animated mouse cursor that travels to each action point and stays visible between actions. browser_video_show_actions takes a style with point, highlight and title CSS declarations; the action point marker and the target highlight are now only shown when styled. (microsoft/playwright#42752, microsoft/playwright#42758)webmcp_<tool>, with the page's own input schema and annotations, so an agent can call them directly and let the page do the work instead of driving its UI. The list follows the current tab, and clients get a tools/list_changed notification when it changes. This replaces browser_webmcp_list / browser_webmcp_call from v0.0.81, which are no longer exposed over MCP. Tool names, descriptions, schemas and results come from the page, so treat them as untrusted input. Pass --no-webmcp (config webmcp: false, env PLAYWRIGHT_MCP_WEBMCP=false) to opt out. WebMCP is experimental, see WebMCP in Chrome for how to enable it. (microsoft/playwright#42671)browser_emulate_media tool emulates media features on the fly: colorScheme, reducedMotion, forcedColors, contrast and the media type (screen / print). Omitted parameters are left unchanged, null clears an override. (microsoft/playwright#42668)--file-paths=absolute (config filePaths: "absolute", env PLAYWRIGHT_MCP_FILE_PATHS=absolute) to get absolute paths instead. (microsoft/playwright#42673)fix(mcp): keep upload modal and reject bad headers — a failed browser_file_upload (e.g. a missing file) reports the error and keeps the file chooser open so it can be retried, and browser_route (opt-in via --caps=network) returns an error for a header that is not in the Name: Value form instead of setting a header named "". (microsoft/playwright#42713)fix(chromium): bypass service workers on the storage state page — browser_storage_state (opt-in via --caps=storage) no longer runs the site's own scripts, or fails when they redirect, for origins with an active service worker (microsoft/playwright#42656). (microsoft/playwright#42664, microsoft/playwright#42741)Configs that use @playwright/mcp@latest pick this release up on the next client restart. To pin it:
npx @playwright/mcp@0.0.82
`browser_webmcp_list` / `browser_webmcp_call` — List and call the tools a page registers through the WebMCP API, letting the page do the work instead
browser_webmcp_list / browser_webmcp_call — List and call the tools a page registers through the WebMCP API, letting the page do the work instead of driving its UI. When a page has WebMCP tools, the page status reports how many are available (#42613). WebMCP is experimental, see WebMCP in Chrome for how to enable it.--profile-dir-name <name> option (env PLAYWRIGHT_MCP_PROFILE_DIR_NAME) selects the Chrome profile to connect to in extension mode when the extension is installed in several profiles, for example "Profile 1" (#42527)--idle-timeout <ms> (config timeouts.idle, env PLAYWRIGHT_MCP_IDLE_TIMEOUT) to change the timeout, 0 disables it. Headed and attached browsers are not closed unless a timeout is set explicitly (#42663, #42676)--image-responses accepts only: a response that carries an image consists of the image parts alone, without the text part (#42672)browser_close returns an error when the browser context is shared (--shared-browser-context) instead of breaking the calling client's session. This supersedes the v0.0.80 change that dropped the backend after browser_close (#42495)--shared-browser-context, browser_start_recording / browser_stop_recording (opt-in via --caps=devtools) keep each client's recording separate instead of delivering one client's recorded actions to another (#42622, #42627)sub/shot.png) no longer fail with ENOENT; browser_file_upload and browser_drop resolve relative paths against the workspace root (#42540)PLAYWRIGHT_MCP_EXTENSION_TOKEN set, a connection that never completes (e.g. the token belongs to another Chrome profile) now fails after 30 seconds with a hint instead of hanging the tool call forever (#42525)`browser_start_recording` / `browser_stop_recording` (opt-in via --caps=devtools) — Record actions that the user performs manually in the browser and
browser_start_recording / browser_stop_recording (opt-in via --caps=devtools) — Record actions that the user performs manually in the browser and return them as Playwright code. Useful when the user wants to demonstrate a flow instead of describing it (#42359)--codegen language is inferred from the environment (#42150)--user-data-dir in extension mode (#42190)browser_take_screenshot returns the original screenshot bytes instead of silently downscaling them to model-specific limits (#42406)browser_close with a shared browser context, so subsequent tool calls from the same client no longer fail (#42365)browserInfo reports the browser actually running remotely instead of the configured one (#42228)chromiumSandbox setting from the config file (#42288)/killkillkill endpoint is no longer registered outside of tests (#42133)`browser_take_screenshot` — WebP format — New type option to pick the image format (png, jpeg or webp); when unset, the format is inferred from the fi
browser_take_screenshot — WebP format — New type option to pick the image format (png, jpeg or webp); when unset, the format is inferred from the filename extension (#41152)--codegen — more languages — Code generation now supports python, java and csharp in addition to typescript (#42106)--timeout-settle flag (and timeouts.settle config option) to control how long to wait after each action for triggered work (navigations, requests) to settle, defaults to 500ms (#41924)--snapshot-boxes flag (and snapshot.boxes config option) to enable bounding boxes in snapshots globally — previously this was only available per command (#42102)net::ERR_ABORTED navigation errors (#41933)--output-mode CLI option (#41833)Host and Origin headers on CDP relay WebSocket upgrades (#42103)noDefaults for extension CDP connections (#42119)PLAYWRIGHT_MCP_EXECUTABLE_PATH in the error shown when the browser executable is not found (#42122)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
`browser_find` — Search the accessibility snapshot of the current page for text or a regular expression. Returns matching snapshot nodes with a few li
browser_find — Search the accessibility snapshot of the current page for text or a regular expression. Returns matching snapshot nodes with a few lines of surrounding context (like search snippets), which is cheaper than capturing the whole snapshot when you only need to locate an element and its ref (#41605, #41654)--mobile flag and --device option to emulate mobile devices from the CLI (#41657)browser_navigate now surfaces non-2xx navigation status codes (#41589)browser_navigate no longer crashes the response when navigation closes the last tab (e.g. privileged pages like chrome://) (#41675)noDefaults for CDP connections so attaching no longer applies unwanted default context options (#41676)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per month.