# Chrome DevTools MCP (MCP Server)

> Let coding agents control and debug a live Chrome browser

- Type: MCP server
- Publisher: Google Chrome DevTools (official)
- Categories: Development
- Website: https://github.com/ChromeDevTools/chrome-devtools-mcp
- Docs: https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/tool-reference.md
- Source: https://github.com/ChromeDevTools/chrome-devtools-mcp
- Transport: stdio
- Launch command: npx -y chrome-devtools-mcp@latest
- Sign-in: none
- GitHub stars: 52845
- Listed: 2025-09-23

## Overview

Chrome DevTools MCP lets a coding agent do what you would otherwise do with DevTools open. It can record a performance trace and explain what slows a page down, list failed network requests, read console errors with source-mapped stack traces, and run a Lighthouse audit. That turns "why is this page slow?" or "why does the submit button do nothing?" into something the agent can investigate and then check again after it changes the code.

It suits front-end developers who want the agent to verify its own work in a real browser.

## From the publisher

Official Chrome DevTools MCP server that gives agents control of a live Chrome instance via Puppeteer. Agents can automate input, inspect network requests and console messages, record performance traces with DevTools insights, run Lighthouse audits and analyze heap snapshots.

## What you need

- **Node.js (an LTS release), npm and Chrome** at the current stable version or newer. Google officially supports only Chrome and Chrome for Testing; other Chromium browsers may work.
- **No account or API key.** It is a local (stdio) server started with `npx`.
- **A client that can start local servers.** The project documents Codex setup (`codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest`); on Windows it also needs a longer startup timeout and a couple of environment variables. The Codex CLI, IDE extension and ChatGPT desktop app share one config.
- **Nothing to launch by hand.** The server starts Chrome with its own profile the first time a tool needs a browser.

## Good to know

- **The agent sees everything in that browser.** Google's README warns that the server lets clients inspect and modify any data in the browser. Don't use it to browse sites with personal or sensitive data.
- **The profile persists.** The default profile in `~/.cache/chrome-devtools-mcp/` isn't cleared between runs. Add `--isolated` for a temporary one.
- **Data goes to Google by default.** Usage statistics are on unless you pass `--no-usage-statistics`, and performance tools may send trace URLs to the Chrome UX Report API (`--no-performance-crux` turns that off).
- **Script execution can be switched off.** `--no-javascript-evaluation` disables `evaluate_script`, though the docs stress it isn't a sandbox.
- **Lighthouse here skips performance.** For performance numbers the agent records a trace instead.
- **Fewer tools if you want them.** `--slim` cuts the tool list to three: navigation, script execution and screenshots.

## Install

1. **Add the server to Codex**

   Codex CLI:

   ```bash
   codex mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest
   ```

   config.toml:

   ```toml
   [mcp_servers.chrome-devtools]
   command = "npx"
   args = ["-y", "chrome-devtools-mcp@latest"]
   ```

   Agents SDK:

   ```python
   from agents import Agent, Runner
   from agents.mcp import MCPServerStdio
   
   async with MCPServerStdio(
       name="Chrome DevTools MCP",
       params={"command": "npx", "args": ["-y", "chrome-devtools-mcp@latest"]},
   ) as server:
       agent = Agent(name="Assistant", mcp_servers=[server])
       result = await Runner.run(agent, "Check the LCP of web.dev and suggest fixes")
       print(result.final_output)
   ```

## Remove it

1. **In Codex**

   Codex CLI:

   ```bash
   codex mcp remove chrome-devtools
   ```

## Tools

- `navigate_page`
- `new_page`
- `list_pages`
- `click`
- `fill_form`
- `take_snapshot`
- `take_screenshot`
- `evaluate_script`
- `list_console_messages`
- `list_network_requests`
- `performance_start_trace`
- `lighthouse_audit`

## Example prompts

- "Check the LCP of web.dev and suggest fixes"
- "Why does the submit button on localhost:8080 not work? Check console errors"
- "List failed network requests on this page"
- "Run a Lighthouse audit on my landing page"

## Also available as

- plugin: [Modern Web Guidance](https://chatgptplugins.directory/plugins/modern-web-guidance.md)

## Chrome DevTools MCP alternatives

- [Playwright MCP](https://chatgptplugins.directory/mcp/playwright.md): Browser automation for agents via Playwright accessibility snapshots
- [GitHub](https://chatgptplugins.directory/mcp/github.md): Manage repos, issues, pull requests and Actions from your AI agent
- [Context7](https://chatgptplugins.directory/mcp/context7.md): Pull up-to-date, version-specific library docs into your coding agent
- [Supabase](https://chatgptplugins.directory/mcp/supabase.md): Manage Supabase databases, migrations, edge functions and logs
- [Stripe](https://chatgptplugins.directory/mcp/stripe.md): Query and act on your Stripe account and search Stripe docs from any agent
- [Atlassian Rovo (Jira & Confluence)](https://chatgptplugins.directory/mcp/atlassian-rovo.md): Work with Jira issues and Confluence pages through Atlassian's hosted MCP

## FAQ

### Can I use Chrome DevTools MCP in ChatGPT?

In Codex, yes, including Codex in the ChatGPT desktop app. ChatGPT on the web only connects to MCP servers over a public HTTPS endpoint or Secure MCP Tunnel, and this server runs as a local command that drives a browser on your machine, so it isn't a good fit there. See [Use plugins and MCP servers in Codex](/tutorials/use-plugins-in-codex) for adding a stdio server.

### Can it use my normal Chrome profile and logins?

Not by default; it starts Chrome with a dedicated profile. With `--autoConnect` (Chrome 144 or later) it attaches to a Chrome you already have open after you enable remote debugging and allow the connection, and it then has access to every open window in that profile. That helps on sites that block sign-in from automated browsers, but it also exposes your real sessions.

### Does Chrome DevTools MCP send data to Google?

By default, yes: Google collects usage statistics such as tool success rates, latency and environment details, separately from Chrome's own metrics. Opt out with `--no-usage-statistics`. Performance tools may also send trace URLs to the Chrome UX Report API for real-user data; `--no-performance-crux` disables that.

### Chrome DevTools MCP or Playwright MCP?

Pick Chrome DevTools MCP for performance traces, Lighthouse audits and deep debugging in Chrome. Pick [Playwright MCP](/mcp/playwright) when you need Firefox or WebKit, or mainly want reliable clicking through user flows. They are independent, so you can add both to the same client.

_Guide updated 2026-10-24. Sources: https://github.com/ChromeDevTools/chrome-devtools-mcp, https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/configuration.md, https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/advanced-usage.md, https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/tool-reference.md, https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/client-configurations.md, https://learn.chatgpt.com/docs/extend/mcp, https://developers.openai.com/apps-sdk/deploy/connect-chatgpt._

---
Source: https://chatgptplugins.directory/mcp/chrome-devtools · Index: https://chatgptplugins.directory/llms.txt · Independent and community-run. Not affiliated with or endorsed by OpenAI. ChatGPT is a trademark of OpenAI.