Navigate web pages, fill forms, click elements, manage tabs, and handle dialogs.
Good to know
Requires Node.js 18 or newer and an MCP client.
Unclaimed
Are you @microsoft?Claim it, and your coding agent keeps it current with each release
Written by 
Are you @microsoft?Claim it, and your coding agent keeps it current with each release
Automate web pages, inspect browser state, and capture screenshots or recordings from an MCP client.
What you can do with Playwright MCP
Inspect page structure through accessibility snapshots without a vision model.
Good to know
-
Read browser console messages and network requests.
Good to know
-
Capture viewport, full-page, or element screenshots.
Good to know
Clients must handle the original image dimensions.
Reuse saved logins or start isolated sessions with an initial storage state.
Good to know
Isolated sessions discard storage when closed unless state is supplied again.
Connect to existing browser tabs and reuse their logged-in state.
Good to know
Requires the Playwright extension in Chrome or Edge and a local MCP server.
Connect to an existing browser through CDP or a remote Playwright endpoint.
Good to know
-
Upload files through browser file choosers.
Good to know
Uploads are restricted to workspace roots unless unrestricted file access is explicitly enabled.
Show all 32
Save session videos and Playwright traces.
Good to know
Start/stop tracing tools require `--caps=devtools`.
Click, drag, or move the mouse using screen coordinates.
Good to know
Requires `--caps=vision`.
Save a web page as a PDF.
Good to know
Requires `--caps=pdf`.
Run browser automation in a container.
Good to know
Docker supports headless Chromium only.
Select the HTML attribute used to identify elements by test ID.
Good to know
Defaults to `data-testid`.
Run a batch of Playwright API calls from an MCP tool.
Good to know
-
Set up pages with Playwright APIs before using them.
Good to know
Provide a TypeScript file with `--init-page`.
Allow or block browser requests by origin.
Good to know
Only trusted origins should be allowed.
Save accessibility snapshots to disk and receive a file link.
Good to know
-
Start and stop browser video recording when needed.
Good to know
Requires `--caps=devtools`.
Switch browser network access offline and back online.
Good to know
Requires `--caps=network`.
Mock responses or modify headers for requests matching a URL pattern.
Good to know
Requires `--caps=network`.
Inspect and change cookies, local storage, session storage, and saved authentication state.
Good to know
Requires `--caps=storage`.
Target elements with CSS or text selectors as well as accessibility references.
Good to know
-
Drop files onto a target element in a web page.
Good to know
-
Show or hide action callouts on recorded browser videos.
Good to know
Requires `--caps=devtools`.
Set a size threshold for evicting old browser output files.
Good to know
Use `--output-max-size`; old output files can be deleted.
Automate a Firefox browser through a `moz-firefox` BiDi channel.
Good to know
-
Search a page's accessibility snapshot for text or a regular expression.
Good to know
-
Browse with a generic mobile device profile.
Good to know
Use `--mobile`; it cannot be combined with `--device`.
Generate browser action code in TypeScript, Python, Java, or C#.
Good to know
Select the language with `--codegen`; `none` disables generation.
Record manually performed browser actions and retrieve them as Playwright code.
Good to know
Requires `--caps=devtools`.
Switch page color scheme, reduced motion, forced colors, contrast, or screen/print media during a session.
Good to know
Use `browser_emulate_media`; omitted fields stay unchanged and `null` clears an override.
Call a page's WebMCP tools directly from an MCP client.
Good to know
Experimental WebMCP must be enabled in the browser; schemas, descriptions, and results are supplied by the page.
Before you upgrade Playwright MCP
Newest firstPass `filename` to `browser_find` to save matches instead of including them in the response.
`browser_wait_for` reports when a requested `time` is capped at 30 seconds.
Snapshots quote accessible names that look like regexes, such as `"/home/"`.
Show 49 older
Replace `browser_webmcp_list` and `browser_webmcp_call` from v0.0.81 with exposed `webmcp_<tool>` tools; `--no-webmcp` disables exposure.
Server-launched headless browsers close after one hour without tool calls; the next call relaunches. Set `--idle-timeout=0` to disable; headed/attached browsers have no default timeout.
`browser_close` returns an error with `--shared-browser-context`, superseding the v0.0.80 behavior. Bundled Chromium on Linux disables the sandbox by default.
Select a Chrome profile with `--profile-dir-name`; token-based connections that never complete fail after 30 seconds with a hint.
`browser_start_video` accepts `fps` (default 25) and `cursor: true`; 60 fps is supported.
Action point markers and target highlights are shown only when styled using the `style` parameter of `browser_video_show_actions`.
Symlinks are resolved for file-access checks; files outside allowed roots require `--allow-unrestricted-file-access`, even through a workspace symlink.
Use `--file-paths=absolute` for absolute result links, or `--image-responses=only` for image-only responses. Explicit filenames resolve against the workspace root; nested directories are created.
Supply headers in `Name: Value` form; `browser_route` rejects malformed headers.
The default `--codegen` language is inferred from the environment.
The `type` parameter supports `png`, `jpeg`, and `webp`; when omitted, the filename extension determines the format.
Set `--timeout-settle` or `timeouts.settle` to control the wait after an action; the default is 500 ms.
Enable `--snapshot-boxes` to include bounding boxes in snapshots globally.
Remove the obsolete `--output-mode` option; no replacement is stated in this release.
Upgrade the browser extension before connecting; extension protocol v1 is no longer supported.
Correct malformed JSON configuration files; invalid JSON now reports an error instead of falling back to INI parsing.
Navigation reports non-2xx status codes, and the default browser enables the Chromium sandbox.
Attaching over CDP no longer applies unwanted default browser context options.
Accessibility snapshots are distilled to reduce verbosity.
Set `scale` to `css` or `device`; the documented default is `css`.
Snapshot output omits `data:` URL payloads.
`remoteEndpoint` accepts a `ConnectOptions` object as well as a URL, and `remoteHeaders` is supported.
Replace calls to `browser_run_code` with `browser_run_code_unsafe`.
Read numbered requests from `browser_network_requests`, then call `browser_network_request` with the index for headers/body; both support `filename`.
Providing `filename` omits the base64 image from the response.
Browser context settings such as viewport and headless mode are ignored when attaching through the extension.
Replace `--snapshot-mode=incremental` with `full` or `none`; the documented default is now `full`.
Replace the `includeStatic` parameter of `browser_network_requests` with `static`.
Console output defaults to messages since the last navigation; `all: true` includes messages from the whole session.
The README no longer lists `--save-trace`, `--save-video`, or `--caps=tracing`; use the documented start/stop tools under `--caps=devtools`.
Use `--endpoint` to connect to a bound browser endpoint.
The Playwright MCP Bridge extension is available in the Chrome Web Store.
If upgrading from v0.0.67, change `--no-chromium-sandbox` back to `--no-sandbox` and `--chromium-sandbox` back to `--sandbox`.
Update direct executable calls from `mcp-server-playwright` or `mcp` to `playwright-mcp`; the package's binary mapping changed.
Install `@playwright/cli` for `playwright-cli`; it is no longer a binary of `@playwright/mcp`.
The `--cdp-timeout` flag exposes the CDP connection timeout in milliseconds, defaulting to 30000.
For the CLI, replace `install` with `install-browser`; v0.0.63 renamed `--isolated` to `--in-memory`. These are CLI changes, not changes to the MCP `--isolated` flag.
Read the evidence
CLI browser profiles are in-memory by default in v0.0.64; use `--persistent` or `--profile=<path>` to retain state.
Read the evidence
Replace `--session` with `-s=`; replace `session-*` management with `list`, `close-all`, `kill-all`, and per-session `close` or `delete-data`. There is no stopped session state.
Read the evidence
Set `cdpTimeout` in configuration; the default is 30000 ms, and `0` disables the timeout.
Keep uploads within workspace roots (or `cwd` without roots). Workflows requiring outside files or `file://` URLs must explicitly enable `--allow-unrestricted-file-access`.
Update consumers of recorded video paths to read `outputDir/videos`.
Run the MCP server on the same machine as the browser extension; remote extension connections are no longer supported.
Pass a JavaScript function such as `async (page) => { return await page.title(); }` to `browser_run_code`, instead of a bare snippet.
Successful static resources are excluded by default; set `includeStatic: true` to include them. Console severity is configurable with `--console-level` or the tool's `level`.
Use `--snapshot-mode` to select `incremental`, `full`, or `none`; the default is `incremental`.
Remove `--allowed-origins` and `--blocked-origins`; use an OS policy or the documented `--proxy-server` option for network controls.
Unchanged snapshot subtrees appear as `- ref=<id> [unchanged]`.
Rendered image sizes are capped.
Playwright MCP release history 19
Save matching page elements to a file.
Details
`browser_find` accepts `filename`. Navigation reports page-load dialogs, and WebMCP calls work with current tabs and Chromium 155+.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Behavior changed: Search a page's accessibility snapshot for text or…Now works: Navigate web pages, fill forms, click elements, man…Now works: Call a page's WebMCP tools directly from an MCP cli…Behavior changedBehavior changed: Inspect page structure through accessibility snapsh…Now works: Run browser automation in a container.
Seeded by @iluxav with Codex
v0.0.82
with v0.0.81
with v0.0.81
Call tools exposed by a web page directly through MCP.
Details
WebMCP tools appear as `webmcp_<tool>` and follow the selected tab. Media emulation, absolute result paths, and styled video recording are available.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Added: Call a page's WebMCP tools directly from an MCP cli…Action requiredAdded: Switch page color scheme, reduced motion, forced co…Behavior changed: Reuse saved logins or start isolated sessions with…Behavior changed: Navigate web pages, fill forms, click elements, man…Behavior changed: Connect to existing browser tabs and reuse their lo…Behavior changed: Start and stop browser video recording when needed.Behavior changed: Show or hide action callouts on recorded browser vi…Now works: Record manually performed browser actions and retri…Action required: Upload files through browser file choosers.Behavior changed: Capture viewport, full-page, or element screenshots.Action required: Mock responses or modify headers for requests match…Now works: Inspect and change cookies, local storage, session…
Seeded by @iluxav with Codex
Turn a manually demonstrated browser flow into Playwright code.
Details
`browser_start_recording` and `browser_stop_recording` record manual actions. Screenshots retain their original bytes.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Added: Record manually performed browser actions and retri…Behavior changed: Generate browser action code in TypeScript, Python,…Limit lifted: Capture viewport, full-page, or element screenshots.Now works: Connect to existing browser tabs and reuse their lo…Now works: Navigate web pages, fill forms, click elements, man…Now works: Reuse saved logins or start isolated sessions with…
Seeded by @iluxav with Codex
Capture browser screenshots in WebP format.
Details
Screenshots support WebP, generated code supports more languages, and action settle time is configurable. Obsolete output and extension protocol options are removed.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Behavior changed: Capture viewport, full-page, or element screenshots.Added: Generate browser action code in TypeScript, Python,…Behavior changed: Navigate web pages, fill forms, click elements, man…Behavior changed: Inspect page structure through accessibility snapsh…Action requiredAction required: Connect to existing browser tabs and reuse their lo…Action requiredNow works: Connect to existing browser tabs and reuse their lo…Now works: Connect to an existing browser through CDP or a rem…
Seeded by @iluxav with Codex
Find an element in the accessibility snapshot without retrieving the whole page.
Details
`browser_find` searches text or regexes; `--mobile` enables generic mobile emulation. The default browser now enables the Chromium sandbox.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Added: Search a page's accessibility snapshot for text or…Added: Browse with a generic mobile device profile.Behavior changed: Navigate web pages, fill forms, click elements, man…Behavior changed: Connect to an existing browser through CDP or a rem…Now works: Start and stop browser video recording when needed.Now works: Capture viewport, full-page, or element screenshots.Behavior changed: Inspect page structure through accessibility snapsh…
Seeded by @iluxav with Codex
Choose CSS-pixel or device-pixel screenshots.
Details
`browser_take_screenshot` accepts `scale`; output redaction and browser wait handling are corrected.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Behavior changed: Capture viewport, full-page, or element screenshots.Now works: Read browser console messages and network requests.Behavior changed: Inspect page structure through accessibility snapsh…Now works: Navigate web pages, fill forms, click elements, man…
Seeded by @iluxav with Codex
Show action annotations on browser recordings.
Details
Video action overlays can be shown or hidden. Remote connections accept a `ConnectOptions` object, and output files can be evicted by size.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Added: Show or hide action callouts on recorded browser vi…Behavior changed: Connect to an existing browser through CDP or a rem…Added / inferred: Set a size threshold for evicting old browser outpu…Added: Automate a Firefox browser through a `moz-firefox`…Now works: Navigate web pages, fill forms, click elements, man…
Seeded by @iluxav with Codex
v0.0.75
with v0.0.71, v0.0.72, v0.0.73, v0.0.74
with v0.0.71, v0.0.72, v0.0.73, v0.0.74
Manage multiple browser tabs through the extension.
Details
Extension mode supports multiple tabs. Network output becomes a numbered list with a separate detail tool, and the code execution tool is renamed.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Limit lifted: Connect to existing browser tabs and reuse their lo…Action required: Run a batch of Playwright API calls from an MCP too…Action required: Read browser console messages and network requests.Behavior changed: Capture viewport, full-page, or element screenshots.Added: Drop files onto a target element in a web page.Now works: Connect to an existing browser through CDP or a rem…Behavior changed: Connect to existing browser tabs and reuse their lo…Now works: Reuse saved logins or start isolated sessions with…
Seeded by @iluxav with Codex
Read the evidence
- microsoft/playwright-mcp/releases/tag/v0.0.74
- microsoft/playwright-mcp/blob/v0.0.74/README.md
- microsoft/playwright-mcp/releases/tag/v0.0.72
- microsoft/playwright-mcp/blob/v0.0.72/README.md
- microsoft/playwright-mcp/releases/tag/v0.0.71
- microsoft/playwright-mcp/blob/v0.0.71/README.md
- microsoft/playwright-mcp/releases/tag/v0.0.75
- microsoft/playwright-mcp/blob/v0.0.75/README.md
v0.0.70
with v0.0.69
with v0.0.69
Switch a browser offline to reproduce a lost internet connection.
Details
`browser_network_state_set` toggles offline mode. The tagged documentation also exposes network mocking, browser storage tools, and a changed snapshot mode.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Added: Switch browser network access offline and back onli…Added / inferred: Mock responses or modify headers for requests match…Added / inferred: Inspect and change cookies, local storage, session…Action required / inferred: Inspect page structure through accessibility snapsh…Action required / inferred: Read browser console messages and network requests.Behavior changed / inferred: Read browser console messages and network requests.Now works: Navigate web pages, fill forms, click elements, man…Action required / inferred: Save session videos and Playwright traces.Behavior changed / inferred: Connect to an existing browser through CDP or a rem…Added: Target elements with CSS or text selectors as well…
Seeded by @iluxav with Codex
v0.0.68
with v0.0.67
with v0.0.67
Install the browser bridge from the Chrome Web Store.
Details
The browser bridge is available through the Chrome Web Store; the brief sandbox flag rename is reverted.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Behavior changed: Connect to existing browser tabs and reuse their lo…Action required / inferred
Seeded by @iluxav with Codex
v0.0.64
with v0.0.57, v0.0.58, v0.0.59, v0.0.60, v0.0.61, v0.0.62, v0.0.63
with v0.0.57, v0.0.58, v0.0.59, v0.0.60, v0.0.61, v0.0.62, v0.0.63
Start and stop video recording on demand.
Details
On-demand video recording is available with `--caps=devtools`; `--cdp-timeout` configures connection timeouts. The MCP executable is now `playwright-mcp`.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Added: Start and stop browser video recording when needed.Action required / inferredAction required / inferredBehavior changed / inferred: Connect to an existing browser through CDP or a rem…Action requiredBehavior changedAction required
Seeded by @iluxav with Codex
Read the evidence
- microsoft/playwright-mcp/releases/tag/v0.0.62
- microsoft/playwright-mcp/blob/v0.0.62/README.md
- microsoft/playwright-mcp/blob/v0.0.61/packages/playwright-mcp/package.json
- microsoft/playwright-mcp/blob/v0.0.57/packages/playwright-mcp/package.json
- microsoft/playwright-mcp/blob/v0.0.64/packages/playwright-cli/README.md
- microsoft/playwright-mcp/blob/v0.0.64/packages/playwright-mcp/package.json
- microsoft/playwright-mcp/releases/tag/v0.0.64
- microsoft/playwright-mcp/blob/v0.0.64/README.md
- microsoft/playwright-mcp/releases/tag/v0.0.63
v0.0.56
with v0.0.55
with v0.0.55
Choose how long a CDP browser connection may take.
Details
`cdpTimeout` controls connection timeout. File access is restricted by default, and recorded videos move under `outputDir/videos`.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Behavior changed: Connect to an existing browser through CDP or a rem…Action required: Upload files through browser file choosers.Action required: Save session videos and Playwright traces.
Seeded by @iluxav with Codex
Connect the browser extension to a server on the same machine.
Details
Extension connections are restricted to local MCP servers.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Action required: Connect to existing browser tabs and reuse their lo…
Seeded by @iluxav with Codex
Upload files larger than 50 MB through the extension.
Details
The extension upload size limit is removed; saved snapshot and video configuration fixes are included.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Limit lifted: Upload files through browser file choosers.Now works: Save accessibility snapshots to disk and receive a…Now works: Save session videos and Playwright traces.
Seeded by @iluxav with Codex
v0.0.52
with v0.0.49, v0.0.50, v0.0.51
with v0.0.49, v0.0.50, v0.0.51
Save accessibility snapshots to files instead of inlining them.
Details
`browser_snapshot` accepts `filename`; `browser_run_code` now accepts a function. Console severity and snapshot output are configurable.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Added: Save accessibility snapshots to disk and receive a…Action required / inferred: Run a batch of Playwright API calls from an MCP too…Behavior changed: Read browser console messages and network requests.Behavior changed / inferred: Inspect page structure through accessibility snapsh…
Seeded by @iluxav with Codex
Filter which origins the browser may request.
Details
The tagged README restores `--allowed-origins` and `--blocked-origins`.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Added / inferred: Allow or block browser requests by origin.
Seeded by @iluxav with Codex
v0.0.47
with v0.0.45, v0.0.46
with v0.0.45, v0.0.46
Run several Playwright actions in one tool call.
Details
`browser_run_code` executes Playwright snippets, and `--init-page` sets up each page. Origin-filter flags were removed.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Added: Run a batch of Playwright API calls from an MCP too…Added: Set up pages with Playwright APIs before using them.Action requiredNow works: Navigate web pages, fill forms, click elements, man…
Seeded by @iluxav with Codex
Read page updates with unchanged snapshot subtrees collapsed.
Details
Incremental snapshots collapse unchanged subtrees; rendered images are size-limited.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Behavior changed: Inspect page structure through accessibility snapsh…Behavior changed: Capture viewport, full-page, or element screenshots.
Seeded by @iluxav with Codex
v0.0.42
Starting point
Starting point
Automate web pages from an MCP client using accessibility snapshots.
Details
This baseline records browser interaction, saved sessions, screenshots, traces, PDFs, and browser connection options available at v0.0.42.
Run `npx @playwright/[email protected]` with Node.js 18 or newer and an MCP client.
Added: Navigate web pages, fill forms, click elements, man…Added: Inspect page structure through accessibility snapsh…Added: Read browser console messages and network requests.Added: Capture viewport, full-page, or element screenshots.Added: Reuse saved logins or start isolated sessions with…Added: Connect to existing browser tabs and reuse their lo…Added: Connect to an existing browser through CDP or a rem…Added: Upload files through browser file choosers.Added: Save session videos and Playwright traces.Added: Click, drag, or move the mouse using screen coordin…Added: Save a web page as a PDF.Added: Run browser automation in a container.Added: Select the HTML attribute used to identify elements…
Seeded by @iluxav with Codex