← Back to Puppeteer MCP Server

Install Puppeteer MCP Server

Pick your client, copy the command, done.

1

Add it to Claude Code

claude mcp add puppeteer-mcp -- npx -y @modelcontextprotocol/server-puppeteer

Available Tools (7)

Once configured, Puppeteer MCP Server gives your AI agent access to:

puppeteer_navigateNavigate to any URL in the browser
urllaunchOptionsallowDangerous
puppeteer_screenshotCapture screenshots of the entire page or specific elements
nameselectorwidthheightencoded
puppeteer_clickClick elements on the page
selector
puppeteer_hoverHover elements on the page
selector
puppeteer_fillFill out input fields
selectorvalue
puppeteer_selectSelect an element with SELECT tag
selectorvalue
puppeteer_evaluateExecute JavaScript in the browser console
script

Try It Out

After setup, try these prompts with your AI agent:

Navigate to https://example.com and take a screenshot of the main content area.
Go to the login page, fill in the username and password fields, and click the submit button.
Execute a script to extract all the product titles from the current page and return them as a list.
Check the browser console logs for any errors after navigating to the target URL.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • Docker installed and running
Alternative installation methods

Docker

docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer

Keep this setup from going cold

Save the docs, env vars, and workflow around Puppeteer MCP Server in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup