MCP Puppeteer Linux MCP Server

A Model Context Protocol server for browser automation using Puppeteer with Linux display server support

Local serverstdio

What is the MCP Puppeteer Linux MCP server?

A Model Context Protocol server for browser automation using Puppeteer with Linux display server support. The mcp puppeteer linux mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 11 defined tools rather than through you.

What it actually does

A Model Context Protocol server that provides browser automation capabilities using Puppeteer, with full support for Linux display servers (X11 and Wayland). This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.

  • Browser automation with Linux display server support
  • Automatic X11/Wayland detection and configuration
  • Console log monitoring
  • Screenshot capabilities
  • JavaScript execution
  • Basic web interaction (navigation, clicking, form filling)

Adding it to your client

@smithery/cli on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Its toolset

Everything the assistant can do here goes through one of these:

  • puppeteer_navigate — Navigate to any URL in the browser
  • Input — url (string)
  • puppeteer_screenshot — Capture screenshots of the entire page or specific elements
  • Inputs — - name (string, required): Name for the screenshot
  • puppeteer_click — Click elements on the page
  • puppeteer_hover — Hover elements on the page
  • puppeteer_fill — Fill out input fields
  • puppeteer_select — Select an element with SELECT tag
  • puppeteer_evaluate — Execute JavaScript in the browser console
  • Tools — The Tools tool exposed by this server
  • Resources — The server provides access to two types of resources: 1. Console Logs (console://logs) - Browser console output in text format - Includes all

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 11 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch MCP Puppeteer Linux.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the mcp puppeteer linux mcp server does with a few real requests.

When to reach for it

This sits in the browser automation group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. MCP Puppeteer Linux's toolset — puppeteer_navigate, Input, puppeteer_screenshot and 8 more — is a fair guide to whether it matches your workflow. It is maintained by PhialsBasement; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
puppeteer_navigateNavigate to any URL in the browser
Inputurl (string)
puppeteer_screenshotCapture screenshots of the entire page or specific elements
Inputs- name (string, required): Name for the screenshot
puppeteer_clickClick elements on the page
puppeteer_hoverHover elements on the page
puppeteer_fillFill out input fields
puppeteer_selectSelect an element with SELECT tag
puppeteer_evaluateExecute JavaScript in the browser console
ToolsThe Tools tool exposed by this server.
ResourcesThe server provides access to two types of resources: 1. **Console Logs** (console://logs) - Browser console output in text format - Includes all console messages from the browser 2. **Screenshots** (screenshot://<name>)

How to install the MCP Puppeteer Linux MCP server

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["ts-node", "/path/to/index.ts"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use MCP Puppeteer Linux to puppeteer navigate.
  • Use MCP Puppeteer Linux to Input.
  • Use MCP Puppeteer Linux to puppeteer screenshot.

Frequently asked questions

It connects MCP Puppeteer Linux to MCP-compatible AI assistants such as Claude and Cursor, exposing 11 tools (puppeteer_navigate, Input, puppeteer_screenshot, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP Puppeteer Linux directly.