Playwright Tools

MCP server for browser automation and GUI testing with Playwright.

Control a browser via chat: navigate, click, fill forms, take screenshots — and record everything as pytest test code.

Features

• Browser automation — Navigation, interaction, content extraction
• Test recording — Record actions → generate pytest code
• Dual transport — stdio (Claude Desktop) + Streamable HTTP (remote MCP)
• OAuth 2.0 — Authentication for HTTP access (optional)

Quickstart

stdio (Claude Desktop)

git clone https://github.com/cuber-it/mcp_playwright_tools.git
cd mcp_playwright_tools
python -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/playwright install chromium --with-deps
./run.sh

Claude Desktop config (~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "playwright": {
      "command": "/path/to/mcp_playwright_tools/run.sh"
    }
  }
}

Streamable HTTP

./run.sh --http              # Port 12201 (default)
./run.sh --http 12201        # Explicit port
./run.sh --http --headed     # With browser GUI

Tools

Navigation

• navigate — Open URL
• current_url — Current URL
• go_back / go_forward — Browser history
• reload — Reload page

Content

• get_title — Page title
• get_text / get_all_texts — Text from elements
• get_page_content — Visible page text
• get_html — HTML of an element
• get_links — All links on the page
• get_attribute — Read element attribute

Interaction

• click — Click element
• fill — Fill input field
• type_text — Type character by character
• press — Press key
• select_option / select_option_by_text — Dropdown
• check / uncheck — Checkbox
• hover / focus / clear

Browser

• screenshot / screenshot_element — Screenshots
• wait_for / wait_for_hidden / wait_for_url — Wait for elements/state
• set_headless — Toggle headless/headed mode
• set_viewport — Viewport size
• scroll_to / scroll_page — Scrolling
• get_browser_info — Status info

Recording

• start_recording — Start recording actions
• stop_recording — Stop recording (shows preview)
• save_test — Save as pytest file
• recording_status — Current status

Configuration

Environment Variables

Variable	Default	Description
MCP_HOST	127.0.0.1	Bind address (HTTP mode)
MCP_PORT	12201	Server port
PLAYWRIGHT_HEADLESS	true	Browser headless/headed
MCP_OAUTH_ENABLED	false	Enable OAuth
MCP_OAUTH_SERVER_URL	–	OAuth server URL
MCP_PUBLIC_URL	–	Public server URL

Port Schema

• 12201 — MCP Server (Streamable HTTP)
• 12202 — Health endpoint

Version

v0.2.0 — See CHANGELOG.md