chromedevtools avatar

Chrome Devtools Cli

This is a CLI wrapper around Chrome DevTools Protocol that lets you automate browsers from the command line or scripts. You take snapshots to get element UIDs, then click, fill, or drag them around. State persists across commands, so you can chain actions without ceremony. It handles the stuff you'd expect like navigation, screenshots, and network inspection, plus less common needs like Lighthouse audits, performance traces, and heap snapshots. The snapshot approach is smarter than raw DOM selectors since it uses the accessibility tree. If you're building browser automation that needs to be scriptable or want DevTools power outside the GUI, this does the job without fighting Selenium.

skills.sh installs
8.3K
GitHub stars
55K
last updated
Aug 21, 2026

Install

$ npx -y skills add chromedevtools/chrome-devtools-mcp --skill chrome-devtools-cli --agent claude-code

Installs into .claude/skills of the current project.

Files

The chrome-devtools-mcp CLI lets you interact with the browser from your terminal.

Setup

Note: If this is your very first time using the CLI, see references/installation.md for setup. Installation is a one-time prerequisite and is not part of the regular AI workflow.

AI Workflow

  1. Execute: Run tools directly. If you don't know the target page's ID, run chrome-devtools list_pages to find it. The background server starts implicitly; do not run start/status/stop before each use.
  2. Inspect: Use chrome-devtools take_snapshot <pageId> to get an element <uid>.
  3. Act: Use chrome-devtools click <pageId> <uid>, chrome-devtools fill <pageId> <uid> <value>, etc. State persists across commands.

Snapshot example:

uid=1_0 RootWebArea "Example Domain" url="https://example.com/"
  uid=1_1 heading "Example Domain" level="1"

Permissions & File Access

Sponsors

Details

Repository
github.com/chromedevtools/chrome-devtools-mcp
Categories
AI & Agent Building, Automation & Workflows, CLI & Terminal
First seen
May 16, 2026

More from chromedevtools/chrome-devtools-mcp

All 6
1shopify avatarshopify-onboarding-merchantshopify/shopify-ai-toolkitSet up and connect a Shopify store from your AI assistant. Use when the user wants to start selling online, open a first Shopify store, try Shopify before they 8.2Kskills.sh installs
2msw-git avatarmsw-planningmsw-git/msw-ai-coding-plugins-officialMSW (MapleStory Worlds) game-planning mode — for BOTH starting a brand-new game from scratch AND continuing/resuming an in-progress prototype. Narrow the idea w8.1Kskills.sh installs
3clickhouse avatarchdb-datastoreclickhouse/agent-skillsUse when the user has tabular data (pandas DataFrame, parquet, csv, Arrow, json) and wants to filter, group, aggregate, join, or speed up slow pandas. Provides 8.1Kskills.sh installs
4apify avatarapify-generate-output-schemaapify/agent-skillsGenerate output schemas (dataset_schema.json, output_schema.json, key_value_store_schema.json) for an Apify Actor by analyzing its source code. Use when creatin8Kskills.sh installs
5shubhamsaboo avatarfullstack-developershubhamsaboo/awesome-llm-appsModern web development expertise covering React, Node.js, databases, and full-stack architecture. Use when: building web applications, developing APIs, creating7.9Kskills.sh installs
6clickhouse avatarclickhouse-js-node-troubleshootingclickhouse/agent-skillsTroubleshoot and resolve common issues with the ClickHouse Node.js client (@clickhouse/client). Use this skill whenever a user reports errors, unexpected behavi7.8Kskills.sh installs