mcp-playwright-tools

# mcp-playwright-tools **Version 8.0 — completely rewritten and revised.** Browser tools for AI assistants: open pages, find and act on elements, read what is there, take screenshots and PDFs, work with tabs, frames, cookies, requests, dialogs and downloads, read the console and the network log. Twenty-eight tools, usable as a Python library, from the shell, or served over the Model Context Protocol. - **The way of pointing is a parameter.** Every tool that works on an element takes `by`: `css`, `role`, `text`, `label`, `placeholder` or `testid`. - **Contexts by name.** Every tool takes `context`. Each name is a browser context with its own cookies, storage and tabs, closed when nobody has used it for a while; the browser stops with the last one. A context can pass for a device such as a phone, and its login can be saved and used again. - **Nothing gets lost**: tabs a page opens itself are listed and become the active tab; console messages, responses, dialogs and downloads are recorded from the moment a context opens. - **A screenshot arrives as a picture**, an image content block. - **Boundary**: nothing inside the browser needs a permission. Screenshots are written inside the allowed roots and `/tmp`, files are uploaded from the working directory and `/tmp`; a person on the host widens that for a limited time with a grant. - **Server** over stdio or streamable HTTP with the MCP SDK, protocol revision 2026-07-28, OAuth for HTTP. ## Installation Python 3.12 or later. ```bash pip install mcp-playwright-tools # the library and pw-browse pip install "mcp-playwright-tools[server]" # and the MCP server playwright install chromium # the browser Playwright brings along ``` A Chrome already installed on the machine works as well: pass `--channel chrome` instead of installing a browser. ## Quick start A client that starts the server itself, over stdio: ```json { "mcpServers": { "playwright": { "command": …