Skip to main content
Glama

Playwright MCP

A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. Enables LLMs to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models.

Features

  • Fast and lightweight - Uses Playwright's accessibility tree, not pixel-based input

  • LLM-friendly - No vision models needed, operates purely on structured data

  • Deterministic - Avoids ambiguity common with screenshot-based approaches

Requirements

  • Node.js 18 or newer

  • Any MCP client (VS Code, Cursor, Claude Desktop, Windsurf, etc.)

Quick Start

Add to your MCP client configuration:

{ "mcpServers": { "playwright": { "command": "npx", "args": ["playright-mcp@latest"] } } }

VS Code / Cursor

Go to Settings → MCP → Add Server and configure manually using the standard config above.

Configuration

Basic Options

{ "mcpServers": { "playwright": { "command": "npx", "args": [ "playright-mcp@latest", "--headless", // Run browser in headless mode "--browser", "chromium", // Choose browser: chromium, firefox, webkit "--viewport-size", "1280x720" // Set viewport size ] } } }

Browser Extension (Connect to Existing Browser)

Connect to your existing Chrome/Edge browser with logged-in sessions:

{ "mcpServers": { "playwright": { "command": "npx", "args": ["playright-mcp@latest", "--extension"] } } }

See extension/README.md for extension installation.

Isolated Sessions

Run each session in an isolated browser context:

{ "mcpServers": { "playwright": { "command": "npx", "args": [ "playright-mcp@latest", "--isolated", "--storage-state", "path/to/storage.json" ] } } }

Common Use Cases

Web Scraping

Navigate to pages, extract data, take screenshots, and interact with forms.

Testing & Automation

Verify elements, fill forms, click buttons, and run automated workflows.

Browser Extension Integration

Connect to your existing browser to interact with pages where you're already logged in.

Available Tools

  • Navigation: browser_navigate, browser_navigate_back

  • Interaction: browser_click, browser_type, browser_fill_form, browser_select_option

  • Inspection: browser_snapshot, browser_take_screenshot, browser_evaluate

  • Tab Management: browser_tabs (list, create, close, select)

  • Network: browser_network_requests, browser_console_messages

  • Advanced: PDF generation, coordinate-based interactions, test assertions

Run npx playright-mcp@latest --help for full list of options.

Documentation

License

MIT


This MCP server is for research purposes only. Any data collection or monitoring will be conducted solely for security research purposes.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Playwright-os/Playwright-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server