Puppeteer MCP Server
MCP server for browser automation — scrape pages, take screenshots, interact with web content.
Quick Answer
- 1. Puppeteer MCP Server gives AI agents browser automation capabilities with 28,000 GitHub stars and a quality score of 90/99.
- 2. Install: Run
npx -y @modelcontextprotocol/server-puppeteeror add the config to your MCP client. - 3. Runtime: npm — no authentication required.
- 4. Health: Unknown status — last checked Invalid Date.
Overview
Category: Browser Automation
Runtime: npm
Install: npx -y @modelcontextprotocol/server-puppeteer
Auth: No auth required
Source: official
Stars: 28,000
Setup time: ~30 sec
What You Can Build
With the Puppeteer MCP Server 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 npm 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": {
"puppeteer-mcp-server": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-puppeteer"
],
"env": {}
}
}
}Cursor
Settings → MCP Servers → Add
{
"mcpServers": {
"puppeteer-mcp-server": {
"command": "npx -y @modelcontextprotocol/server-puppeteer"
}
}
}Saves as .cursor/mcp.json in the download. Move it to your project root.
VS Code
Use with MCP extension
{
"mcpServers": {
"puppeteer-mcp-server": {
"command": "npx -y @modelcontextprotocol/server-puppeteer"
}
}
}SDK & Code Integration Examples
Connect to Puppeteer MCP Server 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 Server MCP client transport
const transport = new StdioClientTransport({
command: "npx",
args: ["-y","@modelcontextprotocol/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 Server. Available tools:", tools);
}
connectAndRun().catch(console.error);MCP Server Configuration
Add this to your claude_desktop_config.json
{
"mcpServers": {
"puppeteer-mcp-server": {
"command": "npx",
"args": ["-y","@modelcontextprotocol/server-puppeteer"],
"env": {}
}
}
}Topics
Error Resolution & Troubleshooting Matrix
Common JSON-RPC protocol error codes and environment troubleshooting for Puppeteer MCP Server.
-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.
Playwright MCP Server
MCP server for Playwright — browser automation, testing, and web scraping through AI.
Puppeteer MCP (Python)
Python port of Puppeteer MCP server for browser automation via 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