How to Install Puppeteer MCP Server in Windsurf

Browser automation for screenshots, scraping, and JavaScript-rendered page interaction

What Puppeteer MCP Server does

Full browser automation via Puppeteer — take screenshots, extract data from JavaScript-rendered pages, interact with web UIs, and run automated browser tasks directly from your AI agent. Features: - Take screenshots of any URL (full page or viewport) - Navigate pages and interact with elements - Fill forms and click buttons programmatically - Extract data from dynamic, JavaScript-rendered content - Evaluate JavaScript in the page context - Handle cookies, sessions, and authentication flows - Works headlessly — no display required Puppeteer MCP is ideal for web scraping tasks that require JavaScript rendering, UI testing automation, web monitoring, and any scenario where simple HTTP fetching isn't enough. Note: Requires Node.js 18+ and runs a local Chromium browser instance.

puppeteer

browser

scraping

screenshots

automation

Installation steps

1Copy the config below
2Open ~/.codeium/windsurf/mcp_config.json
3Paste inside "mcpServers": {}
4Restart Windsurf

Configuration

File location: ~/.codeium/windsurf/mcp_config.json

mcp_config.jsonjson

{
  "puppeteerMcpServer": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-puppeteer"
    ]
  }
}

Full server details GitHub Open Config Editor

Install in other clients

🤖Claude Desktop 💻Claude Code ⌨️Cursor ✨OpenAI ♊Gemini

For maintainers

If you maintain Puppeteer MCP Server, add this badge to your README to show it's verified on CuratedMCP:

[![CuratedMCP Verified](https://curatedmcp.com/api/badge/puppeteer-mcp-server)](https://curatedmcp.com/marketplace/puppeteer-mcp-server)

Related servers

Fetch MCP Server

Fetch any URL and convert web content to clean markdown for AI consumption

Free

Playwright MCP

Powerful browser automation with multi-browser support, screenshots, and test recording

Free

Firecrawl MCP

Advanced web scraping with JavaScript rendering, PDF support, and autonomous research agents

Free