---
title: "Puppeteer MCP Server Setup Guide and Schema"
slug: "puppeteer"
category: "search-web"
package: "@modelcontextprotocol/server-puppeteer"
transport: "stdio"
canonical: "https://mcp-codex.com/servers/puppeteer"
source: "MCP Codex (https://mcp-codex.com)"
dateModified: "2026-09-28"
---

# Puppeteer MCP Server

> Headless Chrome automation, DOM traversal, and screenshot capture.

## Overview
Full headless Chrome browser automation via Puppeteer. Navigate pages, interact with DOM elements, capture screenshots, and extract page content. The official MCP reference implementation for browser automation.

## Quick Install
```bash
npx -y @modelcontextprotocol/server-puppeteer
```

## Client Configurations

### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-puppeteer"
      ]
    }
  }
}
```

### Cursor (`mcp.json`)
```json
{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-puppeteer"
      ]
    }
  }
}
```

### OpenAI Codex CLI (`~/.codex/config.toml`)
```toml
[mcp_servers.puppeteer]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-puppeteer"]
```

## Available Tools (5)

- `puppeteer_navigate`
- `puppeteer_screenshot`
- `puppeteer_click`
- `puppeteer_fill`
- `puppeteer_evaluate`

## Documentation & Links
- Canonical Web Page: https://mcp-codex.com/servers/puppeteer
- Weekly Protocol Changelog: https://mcp-codex.com#newsletter
- GitHub Repository: https://github.com/modelcontextprotocol/servers/tree/main/src/puppeteer
- Setup Tutorial Guide: https://mcp-codex.com/articles/puppeteer-mcp-server-guide