explaingit

executeautomation/mcp-playwright

Analysis updated 2026-07-03

5,511TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

mcp-playwright is a server that lets AI assistants like Claude control a real web browser, opening pages, clicking buttons, filling forms, taking screenshots, and scraping content. It connects to AI tools using the MCP protocol.

Mindmap

mindmap
  root((repo))
    What it does
      Browser control
      Screenshots
      Form filling
      Page scraping
    Protocol
      MCP standard
      AI tool bridge
    AI tools supported
      Claude Desktop
      VS Code Copilot
      Cursor IDE
    Tech stack
      TypeScript
      Node.js
      Playwright
    Features
      143 device profiles
      HTTP mode
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI assistant automatically test a website by clicking through it and checking that buttons and forms work correctly.

USE CASE 2

Ask an AI to scrape specific content from a web page without writing automation scripts yourself.

USE CASE 3

Test a website on 143 preset device profiles by telling Claude to emulate an iPhone, iPad, or Android device.

USE CASE 4

Use natural language instructions inside Claude Desktop or VS Code Copilot to automate repetitive browser tasks.

What is it built with?

TypeScriptNode.jsPlaywrightMCP

How does it compare?

executeautomation/mcp-playwrightgetsentry/xcodebuildmcpuniswap/interface
Stars5,5115,5165,506
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatehard
Complexity3/52/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a compatible AI tool like Claude Desktop or VS Code Copilot and a JSON config block added to its settings file.

In plain English

This project is a server that lets AI assistants like Claude control a real web browser. It connects to AI tools using a protocol called MCP (Model Context Protocol), which is a standard way for AI systems to call external tools. Once connected, the AI can open web pages, click buttons, fill in forms, take screenshots, scrape page content, and run JavaScript, all without a human touching the keyboard. The practical use case is automating repetitive browser tasks by typing instructions to an AI rather than writing automation scripts yourself. You might use it to test a website by telling Claude to visit a page and check that a button works, or to extract data from a page by asking the AI to read specific content. It works inside Claude Desktop, VS Code with GitHub Copilot, Cursor IDE, and similar AI-powered coding environments. Version 1.0.10 added device emulation across 143 preset device profiles. You can ask the AI to test a page as if it were an iPhone 13, an iPad, a Pixel phone, or a desktop browser, and the server adjusts the viewport size, user-agent string, touch support, and pixel ratio automatically to match that device. Installing the server requires running a single npm command. Browser binaries (Chromium, Firefox, or WebKit) download automatically the first time they are needed, so no separate browser installation step is required. Configuration involves adding a short JSON block to your AI tool's settings file that tells it where to find the server. The README includes separate config examples for Claude Desktop, VS Code, and HTTP mode for remote or headless deployments. The project is written in TypeScript and hosted on npm. Full documentation including a list of supported tools and a device quick-reference guide lives on the project's documentation site. The README is shorter than the full documentation, so some details are available only there.

Copy-paste prompts

Prompt 1
Write the JSON config block I need to add to Claude Desktop settings to connect mcp-playwright, then ask Claude to open example.com and take a screenshot.
Prompt 2
Using mcp-playwright with Claude, how do I ask it to fill in a login form, click the submit button, and confirm a success message appears on the next page?
Prompt 3
How do I configure mcp-playwright in VS Code with GitHub Copilot so I can control a browser through the AI assistant? Include the settings file snippet.
Prompt 4
I want Claude to test my website as if it were an iPhone 13 using mcp-playwright. How do I ask it to switch to that device profile?
Prompt 5
Show me how to run mcp-playwright in HTTP mode for a headless or remote deployment and what the config block looks like for that setup.

Frequently asked questions

What is mcp-playwright?

mcp-playwright is a server that lets AI assistants like Claude control a real web browser, opening pages, clicking buttons, filling forms, taking screenshots, and scraping content. It connects to AI tools using the MCP protocol.

What language is mcp-playwright written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Playwright.

How hard is mcp-playwright to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mcp-playwright for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub executeautomation on gitmyhub

Verify against the repo before relying on details.