| name | install-playwright-mcp |
| description | Install Playwright MCP server for browser automation in Claude Code |
| argument-hint | [--scope <scope>] [--headless] |
Install Playwright MCP Server
Install the Playwright MCP server to enable browser automation capabilities.
What This Does
The Playwright MCP server provides:
- Browser automation - Navigate, click, fill forms, take screenshots
- Accessibility snapshots - LLM-friendly structured data, no vision models needed
- Fast and lightweight - Uses Playwright's accessibility tree
Installation Command
Run this command to install:
claude mcp add playwright -- npx @playwright/mcp@latest
Scope Options
--scope local (default): Available only in current project
--scope project: Shared with team via .mcp.json
--scope user: Available across all your projects
claude mcp add playwright --scope user -- npx @playwright/mcp@latest
claude mcp add playwright --scope project -- npx @playwright/mcp@latest
Headless Mode
For headless operation (no visible browser):
claude mcp add playwright -- npx @playwright/mcp@latest --headless
Common Configurations
With specific browser
claude mcp add playwright -- npx @playwright/mcp@latest --browser firefox
With custom viewport
claude mcp add playwright -- npx @playwright/mcp@latest --viewport-size 1920x1080
With isolated sessions (no persistence)
claude mcp add playwright -- npx @playwright/mcp@latest --isolated
Verify Installation
After installation:
- Restart Claude Code
- Run
/mcp to see the playwright server
- Test with: "Navigate to google.com and take a snapshot"
Available Tools After Installation
browser_navigate - Go to URL
browser_click - Click elements
browser_type - Type text
browser_snapshot - Get page accessibility tree
browser_take_screenshot - Capture screenshot
browser_fill_form - Fill multiple form fields
- And many more...
Execution Instructions
When the user runs this command:
-
Determine scope from arguments or ask:
- Default to
local if not specified
-
Run installation:
claude mcp add playwright [--scope <scope>] -- npx @playwright/mcp@latest [options]
-
Verify success by checking output
-
Inform user to restart Claude Code to use the new MCP server