How to add Puppeteer MCP Server (community) to Claude Desktop

Community Puppeteer MCP server that can launch a browser or attach to an existing Chrome window. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 250★ · stdio · no auth

Claude Desktop config for Puppeteer MCP Server (community)

npx -y puppeteer-mcp-server

{
  "mcpServers": {
    "puppeteer-mcp-server-community": {
      "command": "npx",
      "args": [
        "-y",
        "puppeteer-mcp-server"
      ]
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Puppeteer MCP Server (community) config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Puppeteer MCP Server (community)'s tools appear under the 🔌 tools menu.

Before you start

Node.js 18+ (run via npx or a global install)
Chrome/Chromium — bundled by Puppeteer for new instances; for attach mode, an existing Chrome started with `--remote-debugging-port=9222`
No API key or authentication required (local stdio server)

What Puppeteer MCP Server (community) can do in Claude Desktop

puppeteer_connect_active_tab

Attach to an existing Chrome window running with remote debugging on port 9222 and target a non-extension tab

puppeteer_navigate

Navigate the browser to a URL

puppeteer_screenshot

Capture a screenshot of the page or a specific element

puppeteer_click

Click an element by selector

puppeteer_fill

Type text into an input field

puppeteer_select

Choose an option in a select/dropdown element

puppeteer_hover

Hover over an element

puppeteer_evaluate

Execute arbitrary JavaScript in the page context and return the result

Security

Attaching to an existing Chrome over port 9222 gives the agent full access to the user's logged-in sessions and cookies, so only enable that mode deliberately. It can run arbitrary in-page JavaScript, so untrusted target sites can attempt to influence automation.

Puppeteer MCP Server (community) + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Puppeteer MCP Server (community) config there under the "mcpServers" key and restart the client.

Is Puppeteer MCP Server (community) safe to use with Claude Desktop?

Is this the official Puppeteer/Google MCP server?

No. It is a community project by Meraj Mehrabi, described as experimental and inspired by the reference @modelcontextprotocol/server-puppeteer.

How do I connect to my existing Chrome instead of a new browser?

Launch Chrome with `--remote-debugging-port=9222`, then call puppeteer_connect_active_tab. The server attaches to a non-extension tab and keeps Chrome running on disconnect.

Does it require an API key?

No. It runs locally over stdio with no authentication and drives a browser on your own machine.

View repo Full Puppeteer MCP Server (community) page