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
- 01Control authenticated Chrome sessions
- 02Navigate tabs and interact with pages
- 03Inspect DOM, console, and network data
- 04Capture screenshots and performance traces
- 05Record and schedule browser workflows
Use cases
- 01Automate form filling on logged-in sites
- 02Inspect frontend console and network errors
- 03Extract data across multiple tabs
- 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-devtoolsAfter installing, type/chrome-devtoolsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/automation-workflows.mdclaude-code-integration.mddevtools-mcp.mdshortcuts-scheduling.mdtroubleshooting.mdDetails
From the project READMEChrome 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
| Integration | Setup | Best For |
|---|---|---|
| Claude Code + Extension | claude --chrome | Terminal-based browser control |
| Chrome DevTools MCP | claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest | Programmatic automation via MCP tools |
| Capability | Tools/Methods |
|---|---|
| Navigation | Navigate URLs, create/close/switch tabs, resize windows |
| Input | Click, type, fill forms, drag, hover, press keys, upload files |
| Extraction | Read page content, DOM state, console logs, network requests |
| Debugging | Screenshots, DOM snapshots, evaluate JavaScript, performance tracing |
| Emulation | Device emulation, viewport resizing |
| Recording | Record browser interactions as GIFs, save workflow shortcuts |
| Scheduling | Workflow shortcuts with daily/weekly/monthly/annual triggers |
| Requirement | Minimum |
|---|---|
| Google Chrome | Latest stable |
| Claude in Chrome Extension | 1.0.36+ |
| Claude Code CLI | 2.0.73+ |
| Claude Plan | Pro, 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
| Mistake | Correct Pattern |
|---|---|
Running browser automation without --chrome flag | Start Claude Code with claude --chrome or enable Chrome by default via /chrome settings |
| Trying to take over existing tabs | Claude opens new tabs for tasks; it does not hijack tabs you already have open |
| Not handling CAPTCHAs and modal dialogs manually | Claude pauses at CAPTCHAs, login prompts, and modals; dismiss them yourself then tell Claude to continue |
| Using ambiguous instructions for form filling | Be specific about field names, values, and order; ambiguous prompts produce inconsistent results |
| Requesting all console logs without filtering | Specify log patterns or error types; requesting everything floods context with noise |
| Enabling Chrome by default without need | Increases context usage since browser tools are always loaded; use --chrome flag only when needed |
Using DevTools MCP without --scope user | Add --scope user to make the MCP server available across all projects |
Delegation
- Automate repetitive browser workflows across sites: Use
Taskagent with Chrome extension to fill forms, extract data, or navigate multi-step flows - Debug frontend issues with console and network inspection: Use
Exploreagent with DevTools MCP to capture console errors, network failures, and DOM state - Plan complex multi-tab data extraction pipelines: Use
Planagent 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
- Claude Code Chrome integration -- setup, capabilities, and how the extension communicates with Claude Code
- Chrome DevTools MCP tools -- all 26 MCP tools organized by category with configuration options
- Browser automation workflows -- common patterns for testing, data extraction, and content management
- Workflow shortcuts and scheduling -- creating reusable shortcuts and scheduled recurring tasks
- Troubleshooting and best practices -- fixing connection issues, handling dialogs, and security considerations