playwright-mcp

Programmatic browser automation using Playwright MCP server. Use when building Claude Code tools or applications that need web automation, testing, scraping, or browser interaction. Provides structured accessibility-based automation without screenshots or vision models.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️2downloads

When & Why to Use This Skill

The Playwright MCP skill provides a powerful programmatic interface for browser automation, enabling Claude to interact with web pages, perform automated testing, and execute complex web scraping tasks. By utilizing structured accessibility-based snapshots rather than heavy vision models, it offers a fast, reliable, and developer-friendly way to integrate real-time web data and browser-based workflows into AI-driven applications.

Use Cases

  • Automated E2E Testing: Streamline quality assurance by programmatically navigating web applications, interacting with UI elements, and verifying functional states.
  • Dynamic Web Scraping: Extract structured data from modern, JavaScript-heavy websites that require user interaction or complex navigation to access content.
  • Web Workflow Automation: Automate repetitive online tasks such as filling out complex forms, generating PDFs of web pages, and managing multiple browser contexts for isolated sessions.
  • Technical SEO and Performance Auditing: Programmatically inspect network traffic, console logs, and page structures to identify technical issues or performance bottlenecks.
nameplaywright-mcp
descriptionProgrammatic browser automation using Playwright MCP server. Use when building Claude Code tools or applications that need web automation, testing, scraping, or browser interaction. Provides structured accessibility-based automation without screenshots or vision models.

Playwright MCP

Programmatic interface for Playwright MCP server - enables browser automation in Node.js applications using structured accessibility snapshots.

Installation

npm install @playwright/mcp @modelcontextprotocol/sdk

Basic Usage

import http from 'http';
import { createConnection } from '@playwright/mcp';
import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';

// Create MCP server with browser configuration
const connection = await createConnection({ 
  browser: { 
    launchOptions: { headless: true } 
  } 
});

// Connect with SSE transport
const transport = new SSEServerTransport('/messages', res);
await connection.connect(transport);

Configuration Options

See references/configuration.md for full browser and server configuration options.

Available Tools

See references/tools.md for complete tool documentation including:

  • Core automation (click, type, navigate, etc.)
  • Tab management
  • Screenshots and PDF generation
  • JavaScript evaluation
  • Network and console inspection

Common Patterns

Headless automation:

const connection = await createConnection({
  browser: { launchOptions: { headless: true } }
});

With browser channel:

const connection = await createConnection({
  browser: { 
    launchOptions: { 
      channel: 'chrome',
      headless: false 
    } 
  }
});

Isolated contexts:

const connection = await createConnection({
  browser: { 
    isolated: true,
    contextOptions: {
      storageState: 'path/to/storage.json'
    }
  }
});

Documentation