Puppeteer MCP Server (Python Implementation)

@twolven

Basic information

About Puppeteer MCP Server

MCP server providing browser automation via Playwright (Python), enabling LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser.

Puppeteer MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-puppeteer-py": {
      "command": "python",
      "args": [
        "puppeteer_server.py"
      ]
    }
  }
}

Puppeteer MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Puppeteer MCP Server (Python Implementation)?

A Model Context Protocol server that provides browser automation capabilities using Playwright (Python's equivalent to Puppeteer). It enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.

How to use Puppeteer MCP Server (Python Implementation)?

Install the required packages with pip install -r requirements.txt, then install Playwright browsers using playwright install. Start the server by running python puppeteer_server.py, or configure it in Claude Desktop by adding a JSON entry with command "python" and args pointing to the server script.

Key features of Puppeteer MCP Server (Python Implementation)

Full browser automation capabilities
Page navigation to any URL
Screenshot capture of entire page or specific elements
Form interaction (clicking and filling fields)
JavaScript execution in the browser console
Configurable timeouts and detailed error handling
Comprehensive logging (INFO, ERROR, DEBUG levels)

Use cases of Puppeteer MCP Server (Python Implementation)

Automate web browsing tasks for LLM agents to gather information
Capture screenshots of web pages or specific elements for analysis
Programmatically fill forms and click buttons on websites
Execute custom JavaScript to extract data from dynamic pages
Monitor console logs during automated browser sessions

Frequently asked questions

What are the prerequisites for Puppeteer MCP Server (Python Implementation)?

Python 3.8+ and pip are required. Additionally, Playwright browsers must be installed using `playwright install`.

Does the browser run in headless mode?

No, the browser launches in non-headless mode for better debugging.

What is the default viewport size?

The default viewport size is 1280x720.

How are screenshots stored?

Screenshots are stored in memory with base64 encoding.

How does error handling work?

The server provides detailed error messages for navigation failures, element not found, timeout errors, JavaScript execution errors, and screenshot failures.

Comments

More Browser Automation MCP servers

Full Self Browsing

Lakshman Turlapati

DOM-first AI browser automation for Chrome and MCP clients.

194

Puppeteer MCP Server

merajmehrabi

This MCP server provides browser automation capabilities through Puppeteer, allowing interaction with both new browser instances and existing Chrome windows.

474