Puppeteer

What it is

A Model Context Protocol server that provides browser automation using Puppeteer. It lets LLMs interact with web pages, take screenshots, and execute JavaScript in a real browser environment. It exposes tools for navigation, clicking, hovering, filling, selecting and evaluating scripts, plus resources for console logs and screenshots.

Who it's for

• Developers who want an LLM to interact with live web pages through an MCP client such as Claude Desktop or VS Code
• Users who need screenshots, console log capture or JavaScript execution in a real browser
• Users who want to customize Puppeteer launch options for their automation

Requirements

Setup

1. Claude Desktop with NPX (opens a browser window)

   Add this server entry to the Claude Desktop MCP configuration.

   jsonCopy

   {
     "mcpServers": {
       "puppeteer": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
       }
     }
   }

2. Claude Desktop with Docker (headless chromium)

   The Docker implementation uses headless chromium, whereas the NPX version opens a browser window.

   jsonCopy

   {
     "mcpServers": {
       "puppeteer": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "--init",
           "-e",
           "DOCKER_CONTAINER=true",
           "mcp/puppeteer"
         ]
       }
     }
   }

3. VS Code manual install (NPX)

   Add this block to your User Settings (JSON) file (open it via Ctrl + Shift + P and Preferences: Open User Settings (JSON)). Optionally use .vscode/mcp.json in your workspace, where the mcp key is not needed.

   jsonCopy

   {
     "mcp": {
       "servers": {
         "puppeteer": {
           "command": "npx",
           "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
         }
       }
     }
   }

4. Build the Docker image

   Build the image locally from the repository.

   bashCopy

   docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .

Examples

{
  "mcpServers": {
    "mcp-puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"],
      "env": {
        "PUPPETEER_LAUNCH_OPTIONS": "{ \"headless\": false, \"executablePath\": \"C:/Program Files/Google/Chrome/Application/chrome.exe\", \"args\": [] }",
        "ALLOW_DANGEROUS": "true"
      }
    }
  }
}

{
  "url": "https://example.com",
  "launchOptions": {
    "headless": false,
    "defaultViewport": { "width": 1280, "height": 720 }
  }
}

Pros & cons

Images