@playwright/mcp

Features

• https://github.com/microsoft/playwright/commit/c813e9cf5 feat(mcp): allow saving videos for sessions https://github.com/microsoft/playwright/issues/37531

  # video is saved from the creation of the page to the closure of the context (browser_close call).
  npx @playwright/mcp --save-video=800x600
  

• https://github.com/microsoft/playwright/commit/fff065816 feat(mcp): add --init-script option https://github.com/microsoft/playwright/issues/37507

  # the code in web-mocks.js will run on page initialization
  npx @playwright/mcp --init-script=./web-mocks.js
  

• https://github.com/microsoft/playwright/commit/1313fbd47 chore(mcp): introduce allowed-hosts https://github.com/microsoft/playwright/issues/37541

  # Runs MCP server only accessible on 192.168.1.10, defense from DNS rebind
  npx @playwright/mcp --allowed-hosts=192.168.1.10:8080 --port=8080
  

Bugfixes

• https://github.com/microsoft/playwright/commit/da333232e fix(mcp): snapshot for ai fixes https://github.com/microsoft/playwright/issues/37527
• https://github.com/microsoft/playwright/commit/499d084a5 fix(session): an extra check for session log https://github.com/microsoft/playwright/issues/37508
• https://github.com/microsoft/playwright/commit/2f820cb20 fix(mcp): lax file path sanitization https://github.com/microsoft/playwright/issues/37502

https://github.com/microsoft/playwright/commit/afb59a0ec fix(mcp): tolerate malformed roots https://github.com/microsoft/playwright/issues/37492 https://github.com/microsoft/playwright/commit/0574514a0 feat(mcp): support shared browser context https://github.com/microsoft/playwright/issues/37463

https://github.com/microsoft/playwright/commit/29fb93479 fix(mcp): use single output dir https://github.com/microsoft/playwright/pull/37436 https://github.com/microsoft/playwright/commit/f07c8c0ac chore(mcp): --grant-permissions cli option https://github.com/microsoft/playwright/pull/37431 https://github.com/microsoft/playwright/commit/eb39131eb fix(mcp): --allowed/blocked-origins accept origins not hosts https://github.com/microsoft/playwright/pull/37408 https://github.com/microsoft/playwright/commit/b3d666428 chore: fetch roots lazily https://github.com/microsoft/playwright/pull/37399 https://github.com/microsoft/playwright/commit/4968bc611 chore(mcp): allow to pass extension token via env variable https://github.com/microsoft/playwright/pull/37371

• 🔥 Secrets 🔥 - https://github.com/microsoft/playwright/commit/dea31d86d

  When user prompts

  "Authenticate using X-USERNAME / X-PASSWORD"
  

  the secret values for X-USERNAME and X-PASSWORD are not sent to the LLM.

  # secrets.env
  X-USERNAME=<secret_value>
  X-PASSWORD=<secret_value>
  

• Action and navigation timeouts can be configured to go beyond standard 5s/60s. - https://github.com/microsoft/playwright/commit/b37caaaf5

• Clicks with keyboard modifiers - https://github.com/microsoft/playwright/commit/cc69e0773

   "Shift+click the last todo item"
  

• Cdp connection headers for the browsers in the ☁️ https://github.com/microsoft/playwright/commit/3e4efe9d7

b176111 chore: roll Playwright to latest (#971) 29d468d chore: add verification tools section (#957) 78298c3 chore: introduce verification tools (#951) 7fb8b0d fix: browser_tabs select action with index 0 failing due to falsy check (#964) 7774ad9 chore(extension): support custom executablePath (#947)

3d1a60b chore: introduce form filling tool (#935) 86eba22 chore: remove navigate_forward due to low usage counts (#934) 2521a67 chore: merge tabs tool into one (#933)

🔥 Default profile support 🔥

Connect to the default Chrome profile using the companion extension

<img width="415" height="216" alt="Screenshot 2025-08-15 at 5 46 57 PM" src="https://github.com/user-attachments/assets/742c04f0-595c-4c7c-84df-bd315b4a29fd" />

Fixes

91d5d24 chore: handle list roots in the server, with timeout (#898) 3f148a4 docs: add opencode installation instructions (#895) 53c6b6d fix: backtick quote escaping (#871) 24f81a7 fix: emit code for waitfor (#862)

16f3523 chore: do not return fullPage screenshots to the LLM (#849) 3f6837b fix: cursor does not respond to listRoots (#826) a60d7b8 chore: slice profile dirs by root in vscode (#814) 2a86ac7 chore: use pngs by default for screenshots (#797) f600234 chore: record user actions in the session log (#798)

• 2bf57e2 chore: do not snapshot on fill (#767) - // speed up form filling
• a9b9fb8 chore: ping streaming HTTP client and disconnect on connection termination (#764)
• da8a244 chore: one tool experiment (#746) - // experimental encapsulate action in subagent loops
• b1a0f77 chore: save session log (#740) - // experimental log trajectory extensively via CLI --save-session
• 468c84e chore: move page state to tab, do not cache snapshot (#730) - // modal states are local to tabs now
• eeeab4f fix: browser_take_screenshot to not require snapshot unless element is specified (#725)
• 29711d0 chore: use streamable http by default (#716) - // /mcp is now recommended by default
• 1eee30f feat: add fullPage mode to browser_take_screenshot (#704)
• 29ac29e fix: no-sandbox flag logic to only disable sandbox when explicitly passed (#709)

What's new

• 🔥 browser_evaluate tool was added. Evaluate on element to read styles, attributes or globally to run code 012c906
• 💻 Recent console logs are included in the tool results. Agents no longer need to poll for console messages 5bfff0a
• 💻 Page errors are included in console messages a5a57df
• 🏷️ Right click for your userland context menus c97bc6e
• 🖱️ (x,y) - based mouse actions available as opt-in (run mcp server with --caps=vision argument) d61aa16

Misc

• 9545473 chore: remove image reply special case in cursor
• 3061d9a chore: resolve dialog races
• da818d1 chore: make tab indexes 0-based
• fe0c0ff chore: mirror cli options w/ env vars

Breaking

• 825a97d chore: remove generate_test tool for now - We received mixed feedback on the tool, manually prompting to generate tests after actions is still the best practice
• d61aa16 --vision mode has been deprecated and turned into --caps=vision capability
• d61aa16 browser_pdf_save has been moved into a separate capability, run mcp server with --caps=pdf argument.

7fca8f5 chore: roll Playwright to 1.54.1 (#665) 59f1d67 feat(dblclick): add double click (#654)

Issues fixed

• ElementHandle can only be created from FrameDispatcher #538
• Error with CSS selector #537
• MCP Server crashes when a simple button is clicked #524

Notable changes

• docs(readme): fix connection method call in programmatic usage example #532
• Include Cursor One-Click in README.md #531
• Add instructions for MCP server in Qodo Gen #530
• chore: roll playwright to Jun 10th, v1.53 #542

6567795 chore: respect server settings from config (#502) eec177d chore: reuse browser in server mode (#495) 54ed7c3 chore: refactor server, prepare for browser reuse (#490)

9429463 chore: roll Playwright to 5/27 (#485) 9e5ffd2 fix(cursor): allow enforcing images for cursor --image-responses=allow (#478) 13cd1b4 fix: respect browserName in config (#461)

1318e39 chore: fix operation over cdp (#440) aa6ac51 feat(trace): allow saving trajectory as trace (experimental) (#426) fea50e6 chore: introduce resolved config for programmatic operation (#425)

c506027 chore: run w/ sandbox by default, --no-sandbox to opt out (#412) 7be0c88 feat(args): allow configuring proxy, UA, viewport, https errors via args (#410) ce72367 feat(storage): allow passing storage state for isolated contexts (#409) 949f956 feat(ephemeral): allow for non-persistent isolated context operation (#405)

445170a chore: roll playwright 5/9 (#394)

• a6b4b222e chore: upstream the frame tree snapshot #35917
• 3196aff32 chore: experiment with stable aria refs #35900
• 263453a7b chore: relax the visibility test for ai snapshots #35898)
• f89d0ae87 chore: make refs & emitGeneric private for mcp #35888)

c28b480 feat(wait): allow waiting for given text (#390) 57b3c14 chore: only reset network log upon explicit navigation (#377) 85c85bd chore: support custom filename in screenshot function (#349) dd5b41f chore: account for undefined arguments (#400)

c225524 fix: don't error on navigating to a download link (#328) 950d0d1 devops: fix Docker publishing (#369)

4997964 fix: require is not defined (#334)