Puppeteer MCP (Python)
Python port of Puppeteer MCP server for browser automation via AI.
Quick Answer
- 1. Puppeteer MCP (Python) gives AI agents browser automation capabilities with 300 GitHub stars and a quality score of 68/99.
- 2. Install: Run
pip install mcp-server-puppeteeror add the config to your MCP client. - 3. Runtime: python — no authentication required.
- 4. Health: Unknown status — last checked Invalid Date.
Overview
Category: Browser Automation
Runtime: python
Install: pip install mcp-server-puppeteer
Auth: No auth required
Source: community
Stars: 300
Setup time: ~30 sec
What You Can Build
With the Puppeteer MCP (Python) MCP server, your AI assistant can:
- Access browser automation functionality through natural language
- Use the server immediately with no API key setup
- Combine with other MCP servers for cross-tool automation workflows
- Run with python for reliable, consistent deployments
Health Status
One-Click Install
Copy the snippet for your MCP client and paste it in.
Claude Desktop
Add to claude_desktop_config.json
{
"mcpServers": {
"mcp-server-puppeteer-py": {
"command": "pip",
"args": [
"install",
"mcp-server-puppeteer"
],
"env": {}
}
}
}Cursor
Settings → MCP Servers → Add
{
"mcpServers": {
"mcp-server-puppeteer-py": {
"command": "pip install mcp-server-puppeteer"
}
}
}Saves as .cursor/mcp.json in the download. Move it to your project root.
VS Code
Use with MCP extension
{
"mcpServers": {
"mcp-server-puppeteer-py": {
"command": "pip install mcp-server-puppeteer"
}
}
}SDK & Code Integration Examples
Connect to Puppeteer MCP (Python) programmatically using TypeScript or Python MCP SDKs.
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
// Initialize Puppeteer MCP (Python) MCP client transport
const transport = new StdioClientTransport({
command: "pip",
args: ["install","mcp-server-puppeteer"],
});
const client = new Client(
{ name: "mcp-app-client", version: "1.0.0" },
{ capabilities: { tools: {} } }
);
async function connectAndRun() {
await client.connect(transport);
const tools = await client.listTools();
console.log("Connected to Puppeteer MCP (Python). Available tools:", tools);
}
connectAndRun().catch(console.error);MCP Server Configuration
Add this to your claude_desktop_config.json
{
"mcpServers": {
"mcp-server-puppeteer-py": {
"command": "pip",
"args": ["install","mcp-server-puppeteer"],
"env": {}
}
}
}Topics
Error Resolution & Troubleshooting Matrix
Common JSON-RPC protocol error codes and environment troubleshooting for Puppeteer MCP (Python).
-32600 (Invalid Request)Cause: Malformed JSON-RPC payload sent to server
Resolution: Verify MCP client payload adheres to JSON-RPC 2.0 specs.
-32601 (Method Not Found)Cause: Requested tool or resource method does not exist
Resolution: Call list_tools() to inspect supported tool names.
-32602 (Invalid Params)Cause: Missing or invalid tool arguments
Resolution: Check argument schema types against tool definition.
-32603 (Internal Error)Cause: Unhandled execution exception inside server process
Resolution: Inspect process stderr logs or check API key credentials.
AUTH_KEY_MISSINGCause: Required environment variable not set in MCP config
Resolution: Define required API key under 'env' object in claude_desktop_config.json.
STDIO_PIPE_CLOSEDCause: Server process crashed on startup
Resolution: Run install command manually in terminal to inspect error output.
Quality Score
Automated quality ranking of maintaining source repository.
Own this server?
Claim your listing to update description, links, and category — and get a verified badge.
Claim this listing →Similar MCP Servers
Other servers in the Browser Automation category.
Puppeteer MCP Server
MCP server for browser automation — scrape pages, take screenshots, interact with web content.
Playwright MCP Server
MCP server for Playwright — browser automation, testing, and web scraping through AI.
Playwright
Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
Chrome Devtools MCP
Chrome DevTools for coding agents