How to Install Puppeteer MCP Server in Gemini CLI
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.
Installation steps
- 1Copy the config below
- 2Open ~/.gemini/settings.json
- 3Paste inside "mcpServers": {}
- 4Restart Gemini CLI
Configuration
File location: ~/.gemini/settings.json
{
"puppeteerMcpServer": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-puppeteer"
]
}
}Install in other clients
For maintainers
If you maintain Puppeteer MCP Server, add this badge to your README to show it's verified on CuratedMCP:
[](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
Playwright MCP
Powerful browser automation with multi-browser support, screenshots, and test recording
Firecrawl MCP
Advanced web scraping with JavaScript rendering, PDF support, and autonomous research agents