Skip to main content
📖 The AI Tool Bible
Puppeteer MCP Server logo

Puppeteer MCP Server

Reference MCP server that lets LLMs drive a real Chromium browser via Puppeteer.

Free· Free and open source (MIT license). No hosted service; you run it locally under Node/Docker.MCP Servers
Visit website →

In short

This archived reference server enables MCP clients to control a real Chromium browser for tasks like form filling and screenshots. It is best for local development experiments and prototyping, though it is no longer actively maintained.

Best for

Developers prototyping MCP-based agents on their own machine who need an LLM to see and interact with JavaScript-rendered pages without building a bespoke browser harness.

Skip if

Production scraping of anti-bot-protected sites, multi-tenant SaaS agents, or teams that need an actively maintained, sandboxed, session-aware browser tool.

Puppeteer MCP is one of the original reference Model Context Protocol servers published by Anthropic in the modelcontextprotocol/servers repository. It exposes a headful or headless Chromium browser to any MCP-aware client (Claude Desktop, Claude Code, Cursor, VS Code Copilot Chat, Zed, and other MCP hosts) through a small, focused set of Puppeteer-backed tools: puppeteer_navigate, puppeteer_screenshot (full-page or element-scoped, returned as base64 PNGs and stored as named resources), puppeteer_click, puppeteer_hover, puppeteer_fill, puppeteer_select, and puppeteer_evaluate for arbitrary in-page JavaScript. Console logs from the running page are also exposed as an MCP resource so the model can read what the browser is emitting. It is aimed at developers and prompt engineers who want to give an LLM eyes and hands on the live web without wiring up a bespoke browser-automation harness. Typical workflows are ad-hoc research on JavaScript-rendered pages, filling out and submitting forms, capturing visual evidence for agents that write bug reports, scraping a specific element the model can identify on the fly, and letting an agent smoke-test a local staging site. Installation is a single npx or Docker command wired into the host's mcp config; the NPX flavor pops a real Chromium window (useful when you need to sign in interactively), while the Docker flavor runs headless Chromium in a container. Note that as of 29 May 2025 the repo was moved to modelcontextprotocol/servers-archived and marked read-only, so it is now a frozen reference rather than a living project.

Editor's take

The obvious reference implementation for anyone learning MCP: read the source, run it once, understand the pattern, then move on. It's genuinely useful for local experiments, but the May 2025 archival is a real signal - for anything you plan to ship, look at the Playwright MCP server or one of the hosted browser-MCP providers that picked up where this left off.

— The AI Tool Bible editorial team

Pros

  • Zero-config bridge between any MCP client and a real Chromium instance, including JS-heavy SPAs that curl or fetch-based tools cannot see.
  • Complete open-source TypeScript reference implementation, easy to fork as a starting point for a hardened production browser-MCP.
  • Ships both NPX (headful, interactive login friendly) and Docker (headless, sandboxed) install paths.
  • Screenshots are exposed as MCP resources with stable names, so a model can refer back to earlier captures across a conversation.
  • puppeteer_evaluate gives the model an escape hatch to run arbitrary in-page JS when the fixed click/fill/select tool set is not enough.
  • Console log resource lets the agent read runtime errors without a separate devtools bridge.

Cons

  • ⚠️ Archived on 29 May 2025 (read-only) and no longer maintained by Anthropic; expect Puppeteer/Chromium drift over time.
  • ⚠️ Runs a browser on your machine with access to local files and localhost/private IPs, which is a real prompt-injection and SSRF risk if the model visits hostile pages.
  • ⚠️ No built-in proxy rotation, stealth patches, CAPTCHA handling, or Cloudflare-turnstile bypass, so it is not suitable for anti-bot-hardened targets.
  • ⚠️ Selector-based tools rely on the model producing correct CSS selectors; brittle on frequently-changing DOMs.
  • ⚠️ No session persistence, cookie import, or multi-tab management primitives out of the box.
  • ⚠️ Community forks (Playwright MCP, browserless MCP, hyperbrowser, etc.) have moved past this reference in features and active support.

Use cases

Give Claude a browser to research JS-rendered pagesHave an agent fill and submit a web formTake element-scoped screenshots for bug reportsSmoke-test a local staging site from an LLMScrape specific fields the model identifies visuallyAutomate a signed-in web workflow via headful loginExtract data with in-page JS via puppeteer_evaluatePrototype a custom browser-MCP by forking the reference

Frequently asked

Is Puppeteer MCP Server still actively maintained?
No, the repository was moved to modelcontextprotocol/servers-archived and marked read-only on May 29, 2025. It is now a frozen reference implementation rather than a living project.
What specific browser actions can the LLM perform?
The server exposes tools for navigating, taking screenshots, clicking, hovering, filling forms, selecting options, and evaluating arbitrary in-page JavaScript. It also exposes console logs as a resource.
How do I install and run Puppeteer MCP Server?
You can run it locally using a single npx command for a headful browser or a Docker command for a headless container. It requires a Node or Docker environment and is wired into the host's MCP config.
Is this tool suitable for production scraping?
No, it is not recommended for production scraping of anti-bot-protected sites. It lacks built-in proxy rotation, stealth patches, and CAPTCHA handling, and it poses security risks if the model visits hostile pages.

Explore related

Compare with similar tools

All in MCP Servers
AM

Airtable MCP Server

MCP Servers

Model Context Protocol server that gives LLMs full read/write access to your Airtable bases.

Free· Open source (MIT) and free to run. You still need an Airtable account and personal access token; Airtable itself is Free / Team $20 per user/mo / Business $45 per user/mo / Enterprise (custom).Natural-language CRM queries against AirtableLLM-driven lead triage and enrichment
AN

Apple Notes MCP

MCP Servers

Let Claude read your local Apple Notes over the Model Context Protocol.

Free· Free / open-source (MIT). No hosted service; runs locally on your Mac.Personal knowledge retrieval from Apple NotesSearching decade-old meeting notes during a Claude chat
AM

AWS MCP Servers

MCP Servers

Official AWS Labs collection of Model Context Protocol servers for connecting AI coding assistants and agents to AWS services and documentation.

Free· Free and open source (Apache 2.0). AWS service usage billed at standard AWS rates. Optional AWS-hosted 'remote managed' servers included at no additional charge beyond consumed AWS services.AWS infrastructure-as-code scaffolding with CDK or CloudFormationGrounded answers from live AWS documentation
AM

Azure MCP Server

MCP Servers

Official Microsoft MCP server that exposes 40+ Azure services to AI agents under the developer's own Entra ID credentials.

Free· Server is free and MIT-licensed. Azure resource usage is billed separately at standard Azure rates based on whatever services the agent queries or mutates.Natural-language Azure resource inventoryLog Analytics and Kusto (KQL) querying from an agent
BM

Blender MCP

MCP Servers · Model-agnostic; commonly paired with Claude (Sonnet/Opus) via Claude Desktop, but works with any MCP-capable client

Give Claude hands inside Blender — an MCP server for natural-language 3D modeling.

Free· Free and open-source (MIT license). No hosted service, no subscription; you supply your own MCP-capable client (Claude Desktop, Cursor, VS Code, OpenCode) and pay only for whatever LLM the client uses.AI-assisted 3D scene blockingGenerative prop and mesh creation via Hyper3D Rodin
BS

Brave Search MCP

MCP Servers

Give any MCP client web and local search powered by the Brave Search API.

Freemium· Free: $0 USD · Team: $4 USD per user/month · Enterprise: $21 USD per user/monthGrounded web search inside Claude DesktopAgent fact-checking and citation lookup