# Puppeteer MCP

> Automate browser interactions via Puppeteer CLI — navigate pages, take screenshots, click/fill/hover elements, and execute JavaScript. Use when user needs to browse URLs, capture screenshots, fill forms, or run JS in a browser.

- Skill: `makabakaxy/puppeteer-mcp` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add makabakaxy/puppeteer-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/makabakaxy/puppeteer-mcp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: makabakaxy (https://skillmd.com/u/makabakaxy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/makabakaxy/puppeteer-mcp

---


# puppeteer-mcp (via mcp2cli)

Control a Puppeteer-driven browser: navigate, screenshot, interact with elements, and run JavaScript.

## Shortcuts

- `mcp2cli puppeteer <cmd>` (alias for `mcp2cli puppeteer-mcp`)

## Commands

### page
| Command | Description | Example | Ref |
|---|---|---|---|
| `mcp2cli puppeteer page navigate` | Navigate to a URL | `mcp2cli puppeteer page navigate --url https://example.com` | [ref](reference/page.md) |
| `mcp2cli puppeteer page screenshot` | Take a screenshot of the page or element | `mcp2cli puppeteer page screenshot --name my-shot`<br>`mcp2cli puppeteer page screenshot --name elem-shot --selector "#main"` | [ref](reference/page.md) |
| `mcp2cli puppeteer page evaluate` | Execute JavaScript in browser console | `mcp2cli puppeteer page evaluate --script "document.title"` | [ref](reference/page.md) |

### element
| Command | Description | Example | Ref |
|---|---|---|---|
| `mcp2cli puppeteer element click` | Click an element | `mcp2cli puppeteer element click --selector "#submit-btn"` | [ref](reference/element.md) |
| `mcp2cli puppeteer element fill` | Fill an input field | `mcp2cli puppeteer element fill --selector "#email" --value "user@example.com"` | [ref](reference/element.md) |
| `mcp2cli puppeteer element select` | Select a dropdown option | `mcp2cli puppeteer element select --selector "#country" --value "US"` | [ref](reference/element.md) |
| `mcp2cli puppeteer element hover` | Hover over an element | `mcp2cli puppeteer element hover --selector ".menu-item"` | [ref](reference/element.md) |

## Discover Parameters

Append `--help` to any command for full parameter list:

    mcp2cli puppeteer page navigate --help

> **Note**: Use Ref links in the Commands table above to view detailed parameter reference and more examples.

## User Notes

> **MUST READ** [users/skill.md](users/skill.md) for custom workflows and tips.
> **Config**: MCP server settings live in `~/.agents/mcp2cli/servers.yaml` - edit there to take effect.