Install this MCP
Pick your client, then copy the config.
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-puppeteer"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN"
}
}
}
}{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-puppeteer"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN"
}
}
}
}{
"servers": {
"puppeteer": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-puppeteer"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN"
}
}
}
}{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-puppeteer"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN"
}
}
}
}# Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.puppeteer] command = "npx" args = ["-y", "@modelcontextprotocol/server-puppeteer"] [mcp_servers.puppeteer.env] GITHUB_PERSONAL_ACCESS_TOKEN = "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN"
Set up with your agent
Uses the same client as above (Cursor). Paste into that agent.
Install the "Puppeteer MCP" MCP for Cursor in this workspace.
1. Read official install docs: https://github.com/modelcontextprotocol/servers
2. Merge this JSON into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-puppeteer"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITHUB_PERSONAL_ACCESS_TOKEN (required): See repository README.
4. Restart Cursor if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/puppeteer.htmlInstall the "Puppeteer MCP" MCP for Claude Desktop in this workspace.
1. Read official install docs: https://github.com/modelcontextprotocol/servers
2. Merge this JSON into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-puppeteer"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITHUB_PERSONAL_ACCESS_TOKEN (required): See repository README.
4. Restart Claude Desktop if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/puppeteer.htmlInstall the "Puppeteer MCP" MCP for VS Code in this workspace.
1. Read official install docs: https://github.com/modelcontextprotocol/servers
2. Merge this JSON into .vscode/mcp.json:
{
"servers": {
"puppeteer": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-puppeteer"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITHUB_PERSONAL_ACCESS_TOKEN (required): See repository README.
4. Restart VS Code if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/puppeteer.htmlInstall the "Puppeteer MCP" MCP for Windsurf in this workspace.
1. Read official install docs: https://github.com/modelcontextprotocol/servers
2. Merge this JSON into ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"puppeteer": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-puppeteer"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- GITHUB_PERSONAL_ACCESS_TOKEN (required): See repository README.
4. Restart Windsurf if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/puppeteer.htmlInstall the "Puppeteer MCP" MCP for Codex in this workspace. 1. Read official install docs: https://github.com/modelcontextprotocol/servers 2. Merge this TOML under [mcp_servers.*] into ~/.codex/config.toml (or .codex/config.toml in a trusted project): # Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.puppeteer] command = "npx" args = ["-y", "@modelcontextprotocol/server-puppeteer"] [mcp_servers.puppeteer.env] GITHUB_PERSONAL_ACCESS_TOKEN = "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN" 3. Required environment variables / secrets (ask the user; never invent secrets): - GITHUB_PERSONAL_ACCESS_TOKEN (required): See repository README. 4. Restart Codex if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets. Catalog: https://averlo.xyz/launches/puppeteer.html
Try it
After install, paste one of these into your agent.
- Show me what Puppeteer can do
- Set up a simple workflow using Puppeteer
- List the tools available in Puppeteer

