Chrome DevTools MCP

chromedevtools/chrome-devtools-mcpOfficial

The Chrome DevTools MCP server enables AI coding agents to control and inspect live Chrome browser instances through the Model Context Protocol, providing tools for performance analysis, advanced debugging, and reliable automation. It offers capabilities including performance trace recording and analysis, network request inspection, screenshot capture, console message analysis with source mapping, and browser action automation via Puppeteer. The server solves the problem of giving AI assistants direct access to Chrome DevTools functionality for in-depth debugging, performance optimization, and reliable browser automation tasks.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.: 58
GitHub stars: 55.2K
tools: 29
transport: STDIO
last updated: Nov 11, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp chrome-devtools-mcp --name chrome-devtools-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add chrome-devtools-mcp -- npx -y chrome-devtools-mcp

Run in your terminal. Replace YOUR_* placeholders with real values; add --scope user to install for every project.

Tools

Verified live · 29 tools

Verified live against the running server on Jun 10, 2026.

clickClicks on the provided element3 params

Clicks on the provided element

Parameters* required

dblClickboolean

Set to true for double clicks. Default is false.

includeSnapshotboolean

Whether to include a snapshot in the response. Default is false.

uid*string

The uid of an element on the page from the page content snapshot

close_pageCloses the page by its index. The last open page cannot be closed.1 params

Closes the page by its index. The last open page cannot be closed.

Parameters* required

pageId*number

The ID of the page to close. Call list_pages to list pages.

dragDrag an element onto another element3 params

Drag an element onto another element

Parameters* required

from_uid*string

The uid of the element to drag

includeSnapshotboolean

Whether to include a snapshot in the response. Default is false.

to_uid*string

The uid of the element to drop into

emulateEmulates various features on the selected page.7 params

Emulates various features on the selected page.

Parameters* required

colorSchemestring

Emulate the dark or the light mode. Set to "auto" to reset to the default.one of dark · light · auto

cpuThrottlingRatenumber

Represents the CPU slowdown factor. Omit or set the rate to 1 to disable throttling

extraHttpHeadersstring

Extra HTTP headers as a JSON string object, e.g. {"X-Custom": "value", "Authorization": "Bearer token"}. Headers are included into every HTTP request originating from the page and persist across na...

geolocationstring

Geolocation (`<latitude>,<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.

networkConditionsstring

Throttle network. Omit to disable throttling.one of Offline · Slow 3G · Fast 3G · Slow 4G · Fast 4G

userAgentstring

User agent to emulate. Set to empty string to clear the user agent override.

viewportstring

Emulate device viewports '<width>x<height>x<devicePixelRatio>[,mobile][,touch][,landscape]'. 'touch' and 'mobile' to emulate mobile devices. 'landscape' to emulate landscape mode.

evaluate_scriptEvaluate a JavaScript function inside the currently selected page. Returns the response as JSON, so returned values have to be JSON-serializable.4 params

Evaluate a JavaScript function inside the currently selected page. Returns the response as JSON, so returned values have to be JSON-serializable.

Parameters* required

argsarray

An optional list of arguments to pass to the function.

dialogActionstring

Handle dialogs while execution. "accept", "dismiss", or string for response of window.prompt. Defaults to accept.

filePathstring

The absolute or relative path to a file to save the script output to. If omitted, the output is returned inline.

function*string

A JavaScript function declaration to be executed by the tool in the currently selected page. Example without arguments: `() => { return document.title }` or `async () => { return await fetch("e...

fillType text into an input, text area or select an option from a <select> element.3 params

Type text into an input, text area or select an option from a <select> element.

Parameters* required

includeSnapshotboolean

Whether to include a snapshot in the response. Default is false.

uid*string

The uid of an element on the page from the page content snapshot

value*string

The value to fill in. "true" or "false" for checkboxes and toggles, "true" for radio buttons.

fill_formFill out multiple form elements (inputs, selects, checkboxes, radios) at once. ALWAYS prefer this tool over multiple individual 'fill' or 'click' calls when interacting with forms. It is significantly faster, more reliable, and reduces turn count. Example: Fill username, passw...2 params

Fill out multiple form elements (inputs, selects, checkboxes, radios) at once. ALWAYS prefer this tool over multiple individual 'fill' or 'click' calls when interacting with forms. It is significantly faster, more reliable, and reduces turn count. Example: Fill username, passw...

Parameters* required

elements*array

Elements from snapshot to fill out.

includeSnapshotboolean

Whether to include a snapshot in the response. Default is false.

get_console_messageGets a console message by its ID. You can get all messages by calling list_console_messages.1 params

Gets a console message by its ID. You can get all messages by calling list_console_messages.

Parameters* required

msgid*number

The msgid of a console message on the page from the listed console messages

get_network_requestGets a network request by an optional reqid, if omitted returns the currently selected request in the DevTools Network panel.3 params

Gets a network request by an optional reqid, if omitted returns the currently selected request in the DevTools Network panel.

Parameters* required

reqidnumber

The reqid of the network request. If omitted returns the currently selected request in the DevTools Network panel.

requestFilePathstring

The absolute or relative path to a .network-request file to save the request body to. If omitted, the body is returned inline.

responseFilePathstring

The absolute or relative path to a .network-response file to save the response body to. If omitted, the body is returned inline.

handle_dialogIf a browser dialog was opened, use this command to handle it2 params

If a browser dialog was opened, use this command to handle it

Parameters* required

action*string

Whether to dismiss or accept the dialogone of accept · dismiss

promptTextstring

Optional prompt text to enter into the dialog.

hoverHover over the provided element2 params

Hover over the provided element

Parameters* required

includeSnapshotboolean

Whether to include a snapshot in the response. Default is false.

uid*string

The uid of an element on the page from the page content snapshot

lighthouse_auditGet Lighthouse score and reports for accessibility, SEO, best practices, and agentic browsing. This excludes performance. For performance audits, run performance_start_trace3 params

Get Lighthouse score and reports for accessibility, SEO, best practices, and agentic browsing. This excludes performance. For performance audits, run performance_start_trace

Parameters* required

devicestring

Device to emulate.one of desktop · mobiledefault: desktop

modestring

"navigation" reloads & audits. "snapshot" analyzes current state.one of navigation · snapshotdefault: navigation

outputDirPathstring

Directory for reports. If omitted, uses temporary files.

list_console_messagesList all console messages for the currently selected page since the last navigation.5 params

List all console messages for the currently selected page since the last navigation.

Parameters* required

includePreservedMessagesboolean

Set to true to return the preserved messages over the last 3 navigations.default: false

pageIdxinteger

Page number to return (0-based). When omitted, returns the first page.

pageSizeinteger

Maximum number of messages to return. When omitted, returns all messages.

serviceWorkerIdstring

Filter messages to only return messages of the specified service worker.

typesarray

Filter messages to only return messages of the specified resource types. When omitted or empty, returns all messages.

list_network_requestsList all requests for the currently selected page since the last navigation.4 params

List all requests for the currently selected page since the last navigation.

Parameters* required

includePreservedRequestsboolean

Set to true to return the preserved requests over the last 3 navigations.default: false

pageIdxinteger

Page number to return (0-based). When omitted, returns the first page.

pageSizeinteger

Maximum number of requests to return. When omitted, returns all requests.

resourceTypesarray

Filter requests to only return requests of the specified resource types. When omitted or empty, returns all requests.

list_pagesGet a list of pages open in the browser.

Get a list of pages open in the browser.

No parameters. Call it with no arguments.

navigate_pageGo to a URL, or back, forward, or reload. Use project URL if not specified otherwise.6 params

Go to a URL, or back, forward, or reload. Use project URL if not specified otherwise.

Parameters* required

handleBeforeUnloadstring

Whether to auto accept or beforeunload dialogs triggered by this navigation. Default is accept.one of accept · decline

ignoreCacheboolean

Whether to ignore cache on reload.

initScriptstring

A JavaScript script to be executed on each new document before any other scripts for the next navigation.

timeoutinteger

Maximum wait time in milliseconds. If set to 0, the default timeout will be used.

typestring

Navigate the page by URL, back or forward in history, or reload.one of url · back · forward · reload

urlstring

Target URL (only type=url)

new_pageOpen a new tab and load a URL. Use project URL if not specified otherwise.4 params

Open a new tab and load a URL. Use project URL if not specified otherwise.

Parameters* required

backgroundboolean

Whether to open the page in the background without bringing it to the front. Default is false (foreground).

isolatedContextstring

If specified, the page is created in an isolated browser context with the given name. Pages in the same browser context share cookies and storage. Pages in different browser contexts are fully isol...

timeoutinteger

Maximum wait time in milliseconds. If set to 0, the default timeout will be used.

url*string

URL to load in a new page.

performance_analyze_insightProvides more detailed information on a specific Performance Insight of an insight set that was highlighted in the results of a trace recording.2 params

Provides more detailed information on a specific Performance Insight of an insight set that was highlighted in the results of a trace recording.

Parameters* required

insightName*string

The name of the Insight you want more information on. For example: "DocumentLatency" or "LCPBreakdown"

insightSetId*string

The id for the specific insight set. Only use the ids given in the "Available insight sets" list.

performance_start_traceStart a performance trace on the selected webpage. Use to find frontend performance issues, Core Web Vitals (LCP, INP, CLS), and improve page load speed.3 params

Start a performance trace on the selected webpage. Use to find frontend performance issues, Core Web Vitals (LCP, INP, CLS), and improve page load speed.

Parameters* required

autoStopboolean

Determines if the trace recording should be automatically stopped.default: true

filePathstring

The absolute file path, or a file path relative to the current working directory, to save the raw trace data. For example, trace.json.gz (compressed) or trace.json (uncompressed).

reloadboolean

Determines if, once tracing has started, the current selected page should be automatically reloaded. Navigate the page to the right URL using the navigate_page tool BEFORE starting the trace if rel...default: true

performance_stop_traceStop the active performance trace recording on the selected webpage.1 params

Stop the active performance trace recording on the selected webpage.

Parameters* required

filePathstring

The absolute file path, or a file path relative to the current working directory, to save the raw trace data. For example, trace.json.gz (compressed) or trace.json (uncompressed).

press_keyPress a key or key combination. Use this when other input methods like fill() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations).2 params

Press a key or key combination. Use this when other input methods like fill() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations).

Parameters* required

includeSnapshotboolean

Whether to include a snapshot in the response. Default is false.

key*string

A key or a combination (e.g., "Enter", "Control+A", "Control++", "Control+Shift+R"). Modifiers: Control, Shift, Alt, Meta

resize_pageResizes the selected page's window so that the page has specified dimension2 params

Resizes the selected page's window so that the page has specified dimension

Parameters* required

height*number

Page height

width*number

Page width

select_pageSelect a page as a context for future tool calls.2 params

Select a page as a context for future tool calls.

Parameters* required

bringToFrontboolean

Whether to focus the page and bring it to the top.

pageId*number

The ID of the page to select. Call list_pages to get available pages.

take_heapsnapshotCapture a heap snapshot of the currently selected page. Use to analyze the memory distribution of JavaScript objects and debug memory leaks.1 params

Capture a heap snapshot of the currently selected page. Use to analyze the memory distribution of JavaScript objects and debug memory leaks.

Parameters* required

filePath*string

A path to a .heapsnapshot file to save the heapsnapshot to.

take_screenshotTake a screenshot of the page or element.5 params

Take a screenshot of the page or element.

Parameters* required

filePathstring

The absolute path, or a path relative to the current working directory, to save the screenshot to instead of attaching it to the response.

formatstring

Type of format to save the screenshot as. Default is "png"one of png · jpeg · webpdefault: png

fullPageboolean

If set to true takes a screenshot of the full page instead of the currently visible viewport. Incompatible with uid.

qualitynumber

Compression quality for JPEG and WebP formats (0-100). Higher values mean better quality but larger file sizes. Ignored for PNG format.

uidstring

The uid of an element on the page from the page content snapshot. If omitted, takes a page screenshot.

take_snapshotTake a text snapshot of the currently selected page based on the a11y tree. The snapshot lists page elements along with a unique identifier (uid). Always use the latest snapshot. Prefer taking a snapshot over taking a screenshot. The snapshot indicates the element selected in...2 params

Take a text snapshot of the currently selected page based on the a11y tree. The snapshot lists page elements along with a unique identifier (uid). Always use the latest snapshot. Prefer taking a snapshot over taking a screenshot. The snapshot indicates the element selected in...

Parameters* required

filePathstring

The absolute path, or a path relative to the current working directory, to save the snapshot to instead of attaching it to the response.

verboseboolean

Whether to include all possible information available in the full a11y tree. Default is false.

type_textType text using keyboard into a previously focused input2 params

Type text using keyboard into a previously focused input

Parameters* required

submitKeystring

Optional key to press after typing. E.g., "Enter", "Tab", "Escape"

text*string

The text to type

upload_fileUpload a file through a provided element.3 params

Upload a file through a provided element.

Parameters* required

filePath*string

The local path of the file to upload

includeSnapshotboolean

Whether to include a snapshot in the response. Default is false.

uid*string

The uid of the file input element or an element that will open file chooser on the page from the page content snapshot

wait_forWait for the specified text to appear on the selected page.2 params

Wait for the specified text to appear on the selected page.

Parameters* required

text*array

Non-empty list of texts. Resolves when any value appears on the page.

timeoutinteger

Maximum wait time in milliseconds. If set to 0, the default timeout will be used.

Readme

Chrome DevTools for agents

Chrome DevTools for agents (chrome-devtools-mcp) lets your coding agent (such as Antigravity, Claude, Cursor or Copilot) control and inspect a live Chrome browser. It is available as a Model-Context-Protocol (MCP) server and as a CLI. Both give your AI coding assistant access to the full power of Chrome DevTools for reliable automation, in-depth debugging, and performance analysis.

Key features

View the full README on GitHub

Details

Repository: github.com/chromedevtools/chrome-devtools-mcp
Category: Web & Browser Automation
Package: chrome-devtools-mcp
Transport: STDIO
Registry: MCP registry, active
Tools verified: Jun 10, 2026

Related Web & Browser Automation MCP servers

View all

MCP Selenium Serverangiejones/mcp-seleniumAn MCP implementation for Selenium WebDriver411stars

Parallel Browser MCPetairl/parallel-browser-mcpMCP server for parallel browser automation across multiple providers.51stars

Selenium Mcppshivapr/selenium-mcpSelenium Tools for MCP6stars

Stealth Agent Browserykshah1309/stealth-agent-browser-mcpStealth Chromium MCP server with hybrid AOM + Set-of-Mark vision and Readability extraction.1stars

Chrome DevTools MCPdinesh-nalla-se/chrome-devtools-mcpMCP server for Chrome DevTools0stars

Playwright Mcpmicrosoft/playwright-mcpPlaywright Tools for MCP39.5Kstars