chrome-devtools-mcp

name	chrome-devtools-mcp
description	Automate browser interactions via Chrome DevTools — control pages, interact with DOM elements, capture screenshots/snapshots, monitor console/network, evaluate JS, and run performance/Lighthouse audits. Use when user needs to navigate websites, fill forms, take screenshots, test web apps, or analyze page performance.
source_version	0.21.0
source_cli_hash	41e39489
generated_at	2026-04-06T08:25:06.855684+00:00

chrome-devtools-mcp (via mcp2cli)

Automate browser interactions via Chrome DevTools.

Shortcuts

• mcp2cli chrome-devtools <cmd> (alias for mcp2cli 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.