npm @playwright/mcp 0.0.86
v0.0.86

one hour ago

✨ 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> (config sessionName, env PLAYWRIGHT_MCP_SESSION_NAME) and --session-color <color> (config sessionColor, env PLAYWRIGHT_MCP_SESSION_COLOR) alongside --extension. Supported colors are blue, red, yellow, green, pink, purple, cyan and orange. Without overrides, new groups use Playwright · <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 chrome to 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 as report-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-endpoint connections 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 — with browser.contextOptions.locateOnlyVisible: true, targets and locators in browser_run_code_unsafe apply .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_unsafe returns an explicit error when neither code nor filename is supplied (microsoft/playwright#44080). (microsoft/playwright#44087)
  • fix(mcp): do not generate setFiles(undefined) when file chooser is cancelled — calling browser_file_upload without paths cancels 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 — the browser_close description now states that it closes the browser and all open tabs, and its reported code is await browser.close(); rather than page.close(). This corrects the description and output, not the existing browser-wide behavior; use browser_tabs with action: "close" to close one tab (#1864). (microsoft/playwright#44157)
  • fix(mcp): suggest the matching FFmpeg installer for video recording — when browser_start_video (opt-in via --caps=devtools) cannot find FFmpeg, its error retains the expected executable path and points to npx @playwright/mcp install-browser ffmpeg. (microsoft/playwright#44088)
  • fix(chromium): apply timezone to service workers — Chromium service workers now honor browser.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, installs libatomic1 required 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

Don't miss a new mcp release

NewReleases is sending notifications on new releases.