How do I install playwright-mcp-dev?

Run `npx skills add https://github.com/microsoft/playwright --skill playwright-mcp-dev` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does playwright-mcp-dev support?

playwright-mcp-dev works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is playwright-mcp-dev free to use?

Yes. playwright-mcp-dev is free to install and use. It is available from the open Skills registry published by microsoft.

Testing

playwright-mcp-dev▌

Name: playwright-mcp-dev
Availability: InStock
Author: microsoft

microsoft/playwright · updated Apr 8, 2026

$npx skills add https://github.com/microsoft/playwright --skill playwright-mcp-dev

summary

Developer guide for extending Playwright MCP tools and CLI commands.

›Add new MCP tools in packages/playwright/src/mcp/browser/tools/ , register in tools.ts , and define capabilities in config.d.ts
›CLI commands map to MCP tools; register new commands in packages/playwright/src/mcp/terminal/commands.ts and update help generator if adding a category
›Config options require updates across program.ts (CLI option), config.d.ts (definition), and config.ts (implementation and environment mapp

skill.md

MCP

Adding MCP Tools

Create a new tool in packages/playwright/src/mcp/browser/tools/your-tool.ts
Register the tool in packages/playwright/src/mcp/browser/tools.ts
Add ToolCapability in packages/playwright/src/mcp/config.d.ts
Place new tests in tests/mcp/mcp-<category>.spec.ts

Building

Assume watch is running at all times, run lint to see type errors

Testing

Run tests as npm run ctest-mcp <category>
Do not run test --debug

CLI

Adding commands

CLI commands are based on MCP tools. Implement the corresponding MCP tool as per Adding MCP Tools section above, if needed.
Add new CLI category for tool if needed:
- Add Category in packages/playwright/src/mcp/terminal/command.ts
- Update doc generator packages/playwright/src/mcp/terminal/helpGenerator.ts
Register command in packages/playwright/src/mcp/terminal/commands.ts
Update skill file at packages/playwright/src/skill/SKILL.md and references if necessary in packages/playwright/src/skill/references/
Place new tests in tests/mcp/cli-<category>.spec.ts

Adding CLI options or Config options

When you need to add something to config.

packages/playwright/src/mcp/program.ts
- add CLI option and doc
packages/playwright/src/mcp/config.d.ts
- add and document the option
packages/playwright/src/mcp/config.ts
- modify FullConfig if needed
- and CLIOptions if needed
- add it to configFromEnv

Building

Assume watch is running at all times, run lint to see type errors

Testing

Run tests as npm run ctest-mcp cli-<category>
Do not run test --debug

Lint

run npm run flint to lint everything before commit

SKILL File

The skill file is located at packages/playwright/src/skill/SKILL.md. It contains documentation for all available CLI commands and MCP tools. Update it whenever you add new commands or tools. At any point in time you can run "npm run playwright-cli -- --help" to see the latest available commands and use them to update the skill file.