mcpField
C
chrome-devtools

chrome-devtools

github.com/oakossProductivity20138 installsUpdated 11w ago
Repository

About chrome-devtools

chrome-devtools is a skill for controlling a real Chrome browser through Claude, using an authenticated browser session. It supports browser tasks and debugging through Claude Code with the extension or Chrome DevTools MCP.

Key features

  1. 01Control authenticated Chrome sessions
  2. 02Navigate tabs and interact with pages
  3. 03Inspect DOM, console, and network data
  4. 04Capture screenshots and performance traces
  5. 05Record and schedule browser workflows

Use cases

  1. 01Automate form filling on logged-in sites
  2. 02Inspect frontend console and network errors
  3. 03Extract data across multiple tabs
  4. 04Schedule recurring browser tasks

MCP support

Chrome DevTools MCP provides 26 browser automation tools for programmatic control of a real Chrome instance. The skill also documents setup and use with Claude Code and the Chrome extension.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/oakoss/agent-skills --skill chrome-devtools

After installing, type/chrome-devtoolsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
automation-workflows.md
claude-code-integration.md
devtools-mcp.md
shortcuts-scheduling.md
troubleshooting.md

Details

From the project README

Chrome DevTools Skill

Control a real Chrome browser with Claude. The Chrome extension runs inside an authenticated browser session, allowing interaction with sites the user is already logged into -- Gmail, Google Docs, Notion, CRMs, and more.

Overview

Two integration paths exist: Claude Code + Chrome Extension (terminal-based browser control via claude --chrome) and Chrome DevTools MCP (26 browser automation tools via Model Context Protocol). Both operate on a real Chrome instance with existing logins, requiring no re-authentication. The Chrome extension also supports workflow shortcuts, scheduled recurring tasks, and multi-tab coordination independently of Claude Code.

Quick Reference

IntegrationSetupBest For
Claude Code + Extensionclaude --chromeTerminal-based browser control
Chrome DevTools MCPclaude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latestProgrammatic automation via MCP tools
CapabilityTools/Methods
NavigationNavigate URLs, create/close/switch tabs, resize windows
InputClick, type, fill forms, drag, hover, press keys, upload files
ExtractionRead page content, DOM state, console logs, network requests
DebuggingScreenshots, DOM snapshots, evaluate JavaScript, performance tracing
EmulationDevice emulation, viewport resizing
RecordingRecord browser interactions as GIFs, save workflow shortcuts
SchedulingWorkflow shortcuts with daily/weekly/monthly/annual triggers
RequirementMinimum
Google ChromeLatest stable
Claude in Chrome Extension1.0.36+
Claude Code CLI2.0.73+
Claude PlanPro, Team, or Enterprise
Node.js (DevTools MCP)20.19+

Not supported: Other Chromium browsers (Brave, Arc, Edge), WSL, headless mode (extension path only; DevTools MCP supports headless), mobile devices.

Common Mistakes

MistakeCorrect Pattern
Running browser automation without --chrome flagStart Claude Code with claude --chrome or enable Chrome by default via /chrome settings
Trying to take over existing tabsClaude opens new tabs for tasks; it does not hijack tabs you already have open
Not handling CAPTCHAs and modal dialogs manuallyClaude pauses at CAPTCHAs, login prompts, and modals; dismiss them yourself then tell Claude to continue
Using ambiguous instructions for form fillingBe specific about field names, values, and order; ambiguous prompts produce inconsistent results
Requesting all console logs without filteringSpecify log patterns or error types; requesting everything floods context with noise
Enabling Chrome by default without needIncreases context usage since browser tools are always loaded; use --chrome flag only when needed
Using DevTools MCP without --scope userAdd --scope user to make the MCP server available across all projects

Delegation

  • Automate repetitive browser workflows across sites: Use Task agent with Chrome extension to fill forms, extract data, or navigate multi-step flows
  • Debug frontend issues with console and network inspection: Use Explore agent with DevTools MCP to capture console errors, network failures, and DOM state
  • Plan complex multi-tab data extraction pipelines: Use Plan agent to design the workflow steps before executing browser automation
  • Record and schedule recurring browser tasks: Use Chrome extension shortcuts with scheduling for daily/weekly automation

References

Comments

Markdown supported