puppeteer -claude

This MCP server provides Claude Code with comprehensive browser automation capabilities powered by Puppeteer. It exposes a suite of tools that let Claude launch and manage browser instances, open and navigate pages, interact with elements, and capture data from web pages. Core tools include launching a browser (puppeteer_launch), creating and managing pages (puppeteer_new_page, puppeteer_close_page), navigating to URLs (puppeteer_navigate), performing interactions like clicking and typing (puppeteer_click, puppeteer_type), extracting text (puppeteer_get_text), taking screenshots (puppeteer_screenshot), executing custom JavaScript (puppeteer_evaluate), and waiting for elements (puppeteer_wait_for_selector). This enables Claude to automate end-to-end web tasks such as form submissions, data extraction, and visual verification across multiple tabs simultaneously. To use them, you simply invoke the corresponding tool with the appropriate pageId and selectors or scripts as shown in the usage examples in the documentation. After installation, Claude users can ask for available tools and start composing multi-step browser automation flows that match real-world browsing scenarios.

Prerequisites:

• Node.js and npm installed on your system
• Access to run npm or npx commands

Automatic setup (recommended):

npx puppeteer-mcp-claude install

What happens automatically:

1. Downloads the latest version from npm
2. Detects Claude Desktop and Claude Code on your system
3. Configures both applications automatically
4. Creates config files if needed (cross-platform paths)
5. Verifies everything is working
6. Guides you on next steps

Manual installation:

# Install globally (optional)
npm install -g puppeteer-mcp-claude

# Configure for Claude Code
puppeteer-mcp-claude install

Development setup (for contributors):

git clone https://github.com/jaenster/puppeteer-mcp-claude.git
cd puppeteer-mcp-claude
npm install

Build and setup (if working from source):

npm run build
npm run setup-mcp

Tips and considerations:

• After installation, restart Claude applications to ensure the MCP integration is loaded.
• The MCP server supports cross-platform installation; developer notes show path locations for macOS, Linux, and Windows environments.
• If Claude Code doesn't recognize the tools, verify that the MCP server is correctly configured and that Claude Code has been restarted.
• Common issues include browser launch failures; ensure puppeteer_launch is invoked prior to other actions and that the browser binary is accessible.
• Environment variables can be adjusted via the mcp configuration; for production use NODE_ENV=production is suggested in examples.
• Use the provided management commands (install, uninstall, status, help) to troubleshoot and verify the MCP setup across Claude Desktop and Claude Code.
• For debugging, you can run the server in development mode (npm run dev) to see detailed logs of MCP operations.