jaenster/puppeteer-mcp-claude

View on GitHub ↗

Browser automation MCP server for Claude, powered by Puppeteer.

48 ★6 forksTypeScriptUpdated 3mo ago

What you need to know

MCP server that gives Claude Code (or any MCP-aware client) a real browser via Puppeteer - navigate, click, type, run JavaScript, take screenshots, manage cookies, and intercept requests. The browser auto-launches on the first tool call, results are returned both as TOON-format text and structuredContent, and you can attach to an existing logged-in Chrome via CDP. Node >= 18, MIT license.

Install

curl -fsSL https://raw.githubusercontent.com/jaenster/puppeteer-mcp-claude/main/install.sh | bash
npm install -g puppeteer-mcp-claude && claude mcp add puppeteer-mcp-claude -- npx -y puppeteer-mcp-claude serve

Key features

  • ✓14+ tools: navigate, click, type, get_text, screenshot, evaluate, wait_for_selector, cookies, request interception
  • ✓Auto-launches browser on first tool call
  • ✓Connect to an existing Chrome via browserWSEndpoint (stealth, proxies, custom viewport)
  • ✓Screenshots returned inline as MCP image blocks
  • ✓Results in TOON notation plus structuredContent
  • ✓CLI: install, uninstall, status, serve, chrome
Clients: Claude Code · Claude Desktop · Cursor · Codex CLI

Reviewed 2026-08-11

Topics

anthropicbrowser-automationchromiumclaudeclaude-codeclaude-desktopheadless-chromellm-toolsmcpmcp-servermodel-context-protocolpuppeteerscreenshotstdiotypescriptweb-automationweb-scraping
Stars
48★
Forks
6
Language
TypeScript
License
MIT
Created
2025-07-07
Last push
2026-05-15