Playwright MCP by Microsoft

Microsoft's official Playwright server for browser automation through accessibility snapshots instead of screenshots. Runs locally through npx without authentication; needs Node.js 18 or newer.

Local (stdio)No auth

Set up Playwright MCP

Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.

Claude Code

Run in your terminal.

claude mcp add playwright-mcp -- npx @playwright/mcp@latest

Cursor

Merge into ~/.cursor/mcp.json

{
  "mcpServers": {
    "playwright-mcp": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Codex

Run in your terminal.

codex mcp add playwright-mcp -- npx @playwright/mcp@latest

Gemini CLI

Merge into ~/.gemini/settings.json

{
  "mcpServers": {
    "playwright-mcp": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

OpenCode

Merge into ~/.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "playwright-mcp": {
      "type": "local",
      "command": [
        "npx",
        "@playwright/mcp@latest"
      ],
      "enabled": true
    }
  }
}

VS Code

Merge into .vscode/mcp.json

{
  "servers": {
    "playwright-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Using more than one server?Add to a config with other servers

Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, the Cursor JSON goes in claude_desktop_config.json. This is a local server that runs on your machine; see remote vs local servers and authentication and security basics.

Overview

Playwright MCP is Microsoft's official browser automation server, built on the Playwright library and maintained in microsoft/playwright-mcp. It is a different project from the archived Puppeteer reference server, which this registry keeps under the older playwright id. Release v0.0.83 shipped on 28 September 2026, and the repository had commits in October.

The server works on the page's accessibility tree, not on pixels. browser_snapshot returns a structured view of the page, and actions such as browser_click and browser_type target elements from that snapshot, so no vision model is needed. Other tools cover navigation, form filling, dialogs, tabs, console messages, network requests and screenshots. Optional capabilities such as vision, PDF and devtools are switched on with --caps.

Setup is a single local process: npx @playwright/mcp@latest, with Node.js 18 or newer. No account or API key is involved. By default the browser runs headed with a persistent profile. Use --headless to hide the window and --isolated to keep the profile in memory. The browser acts with your local network access and any sessions stored in that profile. Use an isolated profile when you point the agent at sites where you are signed in. Upstream also notes that some coding agents now prefer its CLI-and-skills workflow because it uses fewer tokens.

Example tools

  • browser_navigate
  • browser_snapshot
  • browser_click
  • browser_type
  • browser_take_screenshot
  • browser_network_requests

Tool names are upstream examples. The server's live tool list can differ.

Browse Developer Tools servers

Sources

This page was written from the upstream documentation below and last reviewed on 11 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.