✨ Highlights
- 🗂️ Resume extension tab groups — the connection page now lets you select a whole tab group or several individual tabs, rather than one tab at a time. When a client disconnects, its group stays open and turns gray; select that group on the next connection to continue with the same tabs. The new Manage clients page replaces the status page and lists connected clients and their tabs, with controls to disconnect clients and rotate the token. Each tab has one owner, and dragging it between client groups transfers control. Browser-wide changes such as setting or clearing cookies and granting permissions are now refused, although clients can still read browser-wide data such as cookies. Requires the updated Playwright browser extension. (microsoft/playwright#44047)
- 🎨 Name and color extension sessions — distinguish clients working in the same browser with
--session-name <name>(configsessionName, envPLAYWRIGHT_MCP_SESSION_NAME) and--session-color <color>(configsessionColor, envPLAYWRIGHT_MCP_SESSION_COLOR) alongside--extension. Supported colors are blue, red, yellow, green, pink, purple, cyan and orange. Without overrides, new groups usePlaywright · <client name>and the first unused color. Requires the updated Playwright browser extension. (microsoft/playwright#44047) - 🐧 Install stable Chrome on Linux ARM64 — Playwright's Chrome installer now supports Linux ARM64 instead of rejecting that architecture. Install Chrome with
npx @playwright/mcp@0.0.86 install-browser chrometo use it with the server. (microsoft/playwright#44020)
🐛 Fixes
fix(mcp): keep downloads with the same filename— downloads triggered by browser tools no longer overwrite earlier files with the same suggested name. Collisions receive numeric suffixes, such asreport-1.pdf, including when the original file already exists. (microsoft/playwright#44011)fix(mcp): do not wait for busy pages longer than 10s when connecting over CDP— a tab with an unresponsive renderer no longer blocks--cdp-endpointconnections indefinitely; attachment to that page is limited to 10 seconds so responsive tabs remain usable (microsoft/playwright#44052). (microsoft/playwright#44105)fix(locator): select among visible elements in first/last/nth with locateOnlyVisible— withbrowser.contextOptions.locateOnlyVisible: true, targets and locators inbrowser_run_code_unsafeapply.first(),.last()and.nth()to the visible matches instead of selecting a hidden match and then filtering it out. Explicit visibility filters still take priority. (microsoft/playwright#44083)fix(mcp): validate run-code input—browser_run_code_unsafereturns an explicit error when neithercodenorfilenameis supplied (microsoft/playwright#44080). (microsoft/playwright#44087)fix(mcp): do not generate setFiles(undefined) when file chooser is cancelled— callingbrowser_file_uploadwithoutpathscancels the chooser without emitting invalid upload code or clearing the previously selected files (microsoft/playwright#44091). (microsoft/playwright#44104)fix(mcp): clarify browser_close closes all tabs— thebrowser_closedescription now states that it closes the browser and all open tabs, and its reported code isawait browser.close();rather thanpage.close(). This corrects the description and output, not the existing browser-wide behavior; usebrowser_tabswithaction: "close"to close one tab (#1864). (microsoft/playwright#44157)fix(mcp): suggest the matching FFmpeg installer for video recording— whenbrowser_start_video(opt-in via--caps=devtools) cannot find FFmpeg, its error retains the expected executable path and points tonpx @playwright/mcp install-browser ffmpeg. (microsoft/playwright#44088)fix(chromium): apply timezone to service workers— Chromium service workers now honorbrowser.contextOptions.timezoneId, keeping their dates and times consistent with the pages controlled by the server. (microsoft/playwright#44021)fix(docker): refresh the runtime image— the image now uses Ubuntu Noble with a pinned Node.js 26 runtime, installslibatomic1required by Node.js, and upgrades base packages during the build to pick up available security fixes. (#1852, #1857, #1866, #1867)
📦 Upgrading
Node.js 20 or later is required. The package now declares the same minimum Node.js version as its Playwright dependencies, rather than advertising Node.js 18 support. (#1869)
Configs that use @playwright/mcp@latest pick this release up on the next client restart. To pin it:
npx @playwright/mcp@0.0.86