Puppeteer Browser Control
Browser automation MCP server for Claude, powered by Puppeteer.
What is Puppeteer Browser Control?
Puppeteer Browser Control is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to browser automation mcp server for claude, powered by puppeteer.
Browser automation MCP server for Claude, powered by Puppeteer.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Browser automation MCP server for Claude, powered by Puppete
Use Cases
Maintainer
Works with
Installation
NPM
npx -y puppeteer-mcp-claudeManual Installation
npx -y puppeteer-mcp-claudeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Puppeteer Browser Control
Puppeteer MCP Claude is a browser automation MCP server that gives Claude direct control over a Chromium browser via the Puppeteer library. It exposes 14 tools covering navigation, clicking, typing, screenshot capture, JavaScript evaluation, and cookie management, enabling Claude to interact with real web pages as if it were a user. Developers use it for web scraping, automated testing, form submission, and any task where an AI needs to observe or manipulate live browser state.
Prerequisites
- Node.js 18 or later installed
- Claude Desktop, Claude Code, or another MCP-compatible client
- Chromium or Chrome accessible on the system (Puppeteer downloads one automatically on first run)
- Sufficient system RAM for a headless browser process (at least 2 GB recommended)
Install and register with Claude Code (quickest method)
A single command installs the package globally and registers the MCP server with Claude Code's user-level config.
npm install -g puppeteer-mcp-claude
claude mcp add puppeteer-mcp-claude -- npx -y puppeteer-mcp-claude serveAlternative: automated install script (macOS/Linux)
The project provides a shell script that handles installation and config patching for Claude Desktop automatically.
curl -fsSL https://raw.githubusercontent.com/jaenster/puppeteer-mcp-claude/main/install.sh | bashAlternative: automated install script (Windows)
On Windows, use the PowerShell installer instead.
iwr -useb https://raw.githubusercontent.com/jaenster/puppeteer-mcp-claude/main/install.ps1 | iexAdd to MCP client config manually
For manual configuration, add the server block to claude_desktop_config.json.
{
"mcpServers": {
"puppeteer-mcp-claude": {
"command": "npx",
"args": ["-y", "puppeteer-mcp-claude", "serve"]
}
}
}Restart your MCP client
Quit and reopen Claude Desktop or reload your MCP client so it connects to the Puppeteer server. The 14 browser tools will appear in the tool list.
Puppeteer Browser Control Examples
Client configuration
Minimal claude_desktop_config.json entry to run puppeteer-mcp-claude.
{
"mcpServers": {
"puppeteer-mcp-claude": {
"command": "npx",
"args": ["-y", "puppeteer-mcp-claude", "serve"]
}
}
}Prompts to try
Example tasks you can ask Claude once the Puppeteer browser tools are available.
- "Open github.com, take a screenshot, and describe what you see on the homepage."
- "Navigate to news.ycombinator.com, extract the titles of the top 10 stories, and list them."
- "Go to example.com/login, fill in the username field with 'testuser' and the password field with 'pass123', then click the login button."
- "Navigate to a product page and run JavaScript to extract all prices from the DOM."
- "Take a screenshot of the current page and tell me if there are any error messages visible."Troubleshooting Puppeteer Browser Control
puppeteer_launch fails with 'Could not find Chrome' error
Puppeteer downloads Chromium automatically on first use, but this requires internet access. If in a restricted environment, manually install Chromium and set the PUPPETEER_EXECUTABLE_PATH environment variable to its path.
Browser opens but puppeteer_navigate times out
Some sites take longer to load. The tool uses a default navigation timeout. Ensure the target URL is accessible from your machine and that no proxy or VPN is blocking the request.
puppeteer_screenshot returns a blank or mostly white image
The page may not have finished rendering when the screenshot was taken. Use puppeteer_wait_for_selector before calling puppeteer_screenshot to wait for a key element to appear, ensuring the page is fully loaded.
Frequently Asked Questions about Puppeteer Browser Control
What is Puppeteer Browser Control?
Puppeteer Browser Control is a Model Context Protocol (MCP) server that browser automation mcp server for claude, powered by puppeteer. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Puppeteer Browser Control?
Install via npm with the command: npx -y puppeteer-mcp-claude. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Puppeteer Browser Control?
Puppeteer Browser Control works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Puppeteer Browser Control free to use?
Yes, Puppeteer Browser Control is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Puppeteer Browser Control Alternatives — Similar Browser Automation Servers
Looking for alternatives to Puppeteer Browser Control? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Puppeteer Browser Control in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Puppeteer Browser Control?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.