Chrome DevTools for agents
Chrome DevTools for agents is an MCP server and CLI that lets coding agents control and inspect a live Chrome browser for automation, debugging, performance analysis, user emulation, and pre-shipping verification.
Visit ChromeDevTools/chrome-devtools-mcpOverview
Chrome DevTools for agents, published as chrome-devtools-mcp, is a Model-Context-Protocol server and CLI for coding agents. It lets agents control and inspect a live Chrome browser to automate interactions, debug pages, collect performance insights, and run checks before shipping.
Key Features
- Performance insights from Chrome DevTools traces with actionable findings.
- Advanced browser debugging, including network requests, screenshots, console messages, and source-mapped stack traces.
- Reliable automation through Puppeteer with automatic waiting for action results.
- Live Chrome session connection for inspecting, pausing, and troubleshooting in real time.
- Proactive QA with Lighthouse audits for accessibility, SEO, and performance.
- User experience emulation for responsive designs, geolocations, and real user flows.
Use Cases
- Testing responsive designs and emulating locations or real user flows in a managed browser.
- Debugging a live Chrome session by inspecting network activity, console output, and screenshots.
- Running Lighthouse accessibility, SEO, and performance audits to catch issues before production.
- Using a coding agent to navigate sites, click controls, and verify page behavior through prompts.
Getting Started
- Add the chrome-devtools MCP server to your MCP client using npx -y chrome-devtools-mcp@latest.
- For basic browser tasks, use slim mode with the --slim and --headless flags.
- Run a first prompt to check performance and confirm the browser opens and records a trace.
- Client-specific setup guidance is available for editors and agents such as Antigravity, Claude Code, Cursor, VS Code, Codex, Copilot, and OpenCode.
Deployment & Requirements
- Node.js LTS version.
- Google Chrome current stable version or newer.
- npm.
Before You Adopt
- License: Apache-2.0. Review its terms before using, modifying, or distributing the project.
- Official browser support is limited to Google Chrome and Chrome for Testing; other Chromium-based browsers may produce unexpected behavior.
- Performance tools may send trace URLs to the Google CrUX API for real-user experience data, and this can be disabled with a flag.
- Google collects usage statistics to improve reliability and performance, with opt-out controls available.
