chrome-devtools-mcp (via mcp2cli)
Automate browser interactions via Chrome DevTools.
Shortcuts
mcp2cli chrome-devtools <cmd>(alias formcp2cli chrome-devtools-mcp <cmd>)
Commands
Page
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli chrome-devtools page create |
Open new tab and load URL | mcp2cli chrome-devtools page create --url https://example.com |
ref |
mcp2cli chrome-devtools page list |
List all open pages | mcp2cli chrome-devtools page list |
ref |
mcp2cli chrome-devtools page navigate |
Navigate to URL or go back/forward/reload | mcp2cli chrome-devtools page navigate --type url --url https://example.com |
ref |
mcp2cli chrome-devtools page select |
Select page as active context | mcp2cli chrome-devtools page select --page-id 1 |
ref |
mcp2cli chrome-devtools page close |
Close a page by ID | mcp2cli chrome-devtools page close --page-id 2 |
ref |
mcp2cli chrome-devtools page wait |
Wait for text to appear | mcp2cli chrome-devtools page wait --text '["Loaded"]' |
ref |
mcp2cli chrome-devtools page emulate |
Emulate network/CPU/viewport | mcp2cli chrome-devtools page emulate --network-conditions "Slow 3G" |
ref |
mcp2cli chrome-devtools page resize |
Resize page window | mcp2cli chrome-devtools page resize --width 1280 --height 720 |
ref |
Element
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli chrome-devtools element click |
Click on an element | mcp2cli chrome-devtools element click --uid e12 |
ref |
mcp2cli chrome-devtools element fill |
Type text into input or select option | mcp2cli chrome-devtools element fill --uid e5 --value "hello" |
ref |
mcp2cli chrome-devtools element fill-form |
Fill multiple form elements at once | ref | |
mcp2cli chrome-devtools element type |
Type text into focused input | mcp2cli chrome-devtools element type --text "search query" |
ref |
mcp2cli chrome-devtools element press-key |
Press key or key combination | mcp2cli chrome-devtools element press-key --key "Enter" |
ref |
mcp2cli chrome-devtools element hover |
Hover over an element | mcp2cli chrome-devtools element hover --uid e8 |
ref |
mcp2cli chrome-devtools element drag |
Drag element onto another | ref | |
mcp2cli chrome-devtools element upload |
Upload file through file input | ref |
Capture
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli chrome-devtools capture snapshot |
Take accessibility tree snapshot | mcp2cli chrome-devtools capture snapshot |
ref |
mcp2cli chrome-devtools capture screenshot |
Take screenshot of page or element | mcp2cli chrome-devtools capture screenshot --format png |
ref |
Console & Network
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli chrome-devtools console list |
List console messages | mcp2cli chrome-devtools console list |
ref |
mcp2cli chrome-devtools console get |
Get a console message by ID | mcp2cli chrome-devtools console get --msgid 1 |
ref |
mcp2cli chrome-devtools network list |
List network requests | mcp2cli chrome-devtools network list |
ref |
mcp2cli chrome-devtools network get |
Get network request details | mcp2cli chrome-devtools network get --reqid 5 |
ref |
Script & Dialog
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli chrome-devtools script evaluate |
Evaluate JavaScript in page | mcp2cli chrome-devtools script evaluate --function '() => document.title' |
ref |
mcp2cli chrome-devtools dialog handle |
Accept or dismiss browser dialog | mcp2cli chrome-devtools dialog handle --action accept |
ref |
Performance
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli chrome-devtools performance trace-start |
Start performance trace | mcp2cli chrome-devtools performance trace-start |
ref |
mcp2cli chrome-devtools performance trace-stop |
Stop performance trace | mcp2cli chrome-devtools performance trace-stop |
ref |
mcp2cli chrome-devtools performance analyze |
Analyze a performance insight | ref | |
mcp2cli chrome-devtools performance memory-snapshot |
Capture heap snapshot | mcp2cli chrome-devtools performance memory-snapshot --file-path heap.heapsnapshot |
ref |
mcp2cli chrome-devtools performance lighthouse |
Run Lighthouse audit | mcp2cli chrome-devtools performance lighthouse |
ref |
Discover Parameters
Append --help to any command for full parameter list:
mcp2cli chrome-devtools page navigate --help
Use Ref links above to view detailed parameter reference and more examples.
User Notes
MUST READ users/skill.md for custom workflows and tips. Config: MCP server settings live in
~/.agents/mcp2cli/servers.yaml- edit there to take effect.