microsoft/playwright-mcp

Project overview

Playwright MCP gives language models structured accessibility snapshots of web pages so they can drive browsers deterministically without screenshots or visually-tuned models. It runs as a local MCP server backed by Playwright, requiring only Node.js 18+ or Docker and a compatible MCP client.

Project type

MCP

Use cases

Automation

Deployment

Refer to project documentation

License

Apache-2.0

Best for

• Developers who need to automate browser interactions for AI agents using structured accessibility data rather than screenshots, working locally with a compatible MCP client.

Key capabilities

• Enables language models to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models.
• Provides browser automation capabilities using Playwright through an MCP interface.

Limitations and risks

• The Docker implementation only supports headless chromium at the moment.
• A persistent profile can only be used by one browser instance at a time, so concurrent MCP clients sharing the same workspace will conflict.
• Playwright MCP is not a security boundary and should not be treated as one when assessing attack surface.
• allowUnrestrictedFileAccess is a convenience defense, not a secure boundary; deliberate attempts to reach other directories can be easily worked around.

Getting started

• Install the server on a machine capable of running Node.js 18 or newer, or use Docker. Coding is not required for setup.
• Connect a compatible MCP client such as VS Code, Cursor, or Claude Desktop to interact with the server.

Evidence and sources

• README: A Model Context Protocol (MCP) server that provides browser automation capabilities using [Playwright](https://playwright.dev). This server enables LLMs to interact with web pages…
• GitHub project description: Playwright MCP server
• README: - **Fast and lightweight**. Uses Playwright's accessibility tree, not pixel-based input. - **LLM-friendly**. No vision models needed, operates purely on structured data. - **Deter…
• README: You can run Playwright MCP with persistent profile like a regular browser (default), in isolated contexts for testing sessions, or connect to your existing browser using the brows…
• README: --caps <caps> | comma-separated list of additional capabilities to enable, possible values: vision, pdf, devtools.

Reviewed at: 2026-07-17T09:51:37Z