M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
P

Puppeteer MCP Server

Official
Archived
Headless browser control & screenshots
How to install ↓ Compare GitHub source repository ↗
Category
Browser #6 of 32
Stars
★ 305 Popular
Transport
stdio (local process)
Runtime
Node.js
Credentials
No credential needed
License
MIT
Last commit
⚠
Tools
5
62FMRS · C

Browser automation is powerful and setup is direct, but web side effects and session credentials widen the risk surface; Chromium launch and MCP handshake evidence are not yet recorded.

Strongest · Documentation 14/20 Weakest · Maintenance 10/20

Reliability
14/20
Security and permissions
11/20
Maintenance
10/20
Documentation
14/20
Setup experience
13/20

Reviewed by an editorListed 2026-07-13

Read the FMRS scoring method →

Fit and risk

What it can accessRuns commands or codeUses the networkControls a browser

Best for

  • Testing and collection tasks that need an assistant to inspect rendered pages
  • Development teams automating screenshots, form filling, or browser regression checks

Not for

  • Environments that prohibit automated external browsing or web-account credentials
  • Production-scale scraping that requires advanced anti-bot handling and distributed execution

Required permissions

  • Permission to launch a local Chromium process
  • Network access to target websites and, for authenticated flows, a suitable test account

Risks and side effects

  • Automated clicks and form fills can trigger real submissions or external side effects
  • Screenshots, page content, and browser sessions may expose sensitive information

Setup

Before you start

Runtime：Node.js

Start the server with npx. The required Chromium build is downloaded automatically on first run.

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

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add puppeteer -- npx -y @modelcontextprotocol/server-puppeteer

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After starting the server with the given client config, check that navigate, screenshot, click, fill, and evaluate appear in the client's tool list; then ask it to visit https://example.com and take a screenshot — a returned screenshot confirms the connection. Note: this repo is archived with no security guarantees, so use at your own risk.

Troubleshooting

  1. Confirm Chromium downloaded successfully and is executable
  2. Use the correct headless settings in environments without a desktop
  3. Check target-site connectivity, proxy settings, and certificates

Things to try

Once connected, you can ask your AI assistant things like:

  • Open https://example.com and take a screenshot of the page
  • Navigate to example.com, fill in the search box, and click the submit button
  • Use evaluate to run a snippet of JavaScript on the current page and return the result
  • Take a screenshot of the current browser page so I can see what's displayed

Tools 5

navigate writes
Navigate to a specified URL
screenshot read-only
Capture a screenshot of the current page
click writes
Click an element on the page
fill writes
Fill a form input
evaluate writes
Run a custom script in the page

Use cases

Run regression checks on important website flows
Capture scheduled screenshots for page archives
Collect data from pages that require JavaScript rendering

Supported clients

Claude Desktop
Cursor
Cline

Listed from the project's documentation, not tested by this site.

Overview

This server drives Chromium to navigate pages, fill forms, click elements, and capture screenshots. It lets models inspect and interact with rendered web pages for browser automation, testing, and data collection.

Similar servers

Compare with other MCP servers

More servers from this repository

GitHub MCP ServerPostgreSQL MCP ServerSlack MCP ServerGoogle Drive MCP Server

Source revision 9be4674d1ddf Data synced 2026-10-14 Read the FMRS scoring method