a537a8c8ce
docs: explain new auto connection feature ( #664 )
2025-12-11 20:04:34 +01:00
61ede1c053
fix: Update installation badges in README.md for VS Code ( #660 )
...
Broken images
2025-12-11 14:20:51 +00:00
09111cc164
docs: improve autoConnect docs ( #653 )
...
Mention chrome://inspect/#remote-debugging in CLI docs and error
message.
2025-12-09 11:49:56 +01:00
6ab6d85d50
feat: support --auto-connect to a Chrome instance ( #651 )
...
This PR adds a new connection mode called `--auto-connect`. To activate
it, add the `--auto-connect` flag to the chrome-devtools-mcp server
configuration. With this, chrome-devtools-mcp will automatically connect
to the running Chrome instance by looking up the port and the URL in the
user data dir for the specified `--channel` (by default, `stable`).
Requires Chrome M145.
2025-12-08 12:20:35 +00:00
90ed192c55
docs: Add AX design principles ( #643 )
2025-12-05 15:36:08 +01:00
cc4d065dd6
docs: add VS Code install badges ( #532 )
...
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/531
(Once https://github.com/mcp is the default GA registry in VS Code, the
link can be updated to show the registry page)
---------
Co-authored-by: Alex Rudenko <alexrudenko@chromium.org >
2025-12-03 10:17:29 +01:00
1a16f15546
docs: add Qoder CLI to the MCP client configuration section in the README. ( #552 )
...
This PR adds [Qoder CLI](https://qoder.com/cli ) to the MCP client
configuration section in the README.
The Qoder CLI section:
Follows the same format as other MCP clients
Is placed in alphabetical order (between Qoder and Visual Studio)
Includes a link to the Qoder CLI
[documentation](https://docs.qoder.com/cli/using-cli#mcp-servsers )
Provides the command to add the Chrome DevTools MCP server using
`qodercli mcp add`
---------
Co-authored-by: Test <shaonengtao.snt@alibaba-inc.com >
2025-12-03 10:13:54 +01:00
05cf8cb8a6
docs: clarify browser-url parameter in README ( #613 )
...
Fixes #609
---------
Co-authored-by: Paul Irish <paulirish@users.noreply.github.com >
2025-12-03 10:13:26 +01:00
fcaf55354c
feat: support --user-data-dir ( #622 )
...
Allow configuring Chrome's `--user-data-dir` to allow changing the
defaults to support discovery of running Chrome instances later on.
2025-11-28 10:49:36 +01:00
2d89865ddb
docs: update readme to explain agy's browser integration ( #612 )
2025-11-26 16:28:50 +00:00
fae2608887
docs: Fix Antigravity docs ( #605 )
2025-11-25 10:51:19 +00:00
6f9182f4b6
docs: add Antigravity config ( #580 )
2025-11-19 17:53:12 +01:00
016e2fd6ee
docs: add Factory CLI configuration to MCP clients ( #523 )
...
This PR adds Factory CLI to the MCP client configuration section in the
README.
The Factory CLI section:
- Follows the same format as other MCP clients
- Is placed in alphabetical order (between Cursor and Gemini CLI)
- Includes a link to the Factory documentation
- Provides the command to add the Chrome DevTools MCP server using
`droid mcp add`
2025-11-11 08:42:40 +00:00
8854a3400c
docs: fix typos in README.md exlcude -> exclude ( #513 )
...
drive-by PR to fix some typos I spotted in the readme.
2025-11-03 14:21:34 +01:00
c06f4522ee
refactor: merge emulate tools into one ( #494 )
...
Merges emulateCpu and emulateNetwork into a single tool to reduce token
consumption. Changes descriptions to be more concise.
2025-10-30 08:50:36 +00:00
63a5d824c2
docs: add Windsurf to the editor config README ( #493 )
2025-10-29 10:33:36 +00:00
d177087981
feat: support page reload ( #462 )
...
- merges navigation tools into a single tool.
- adds reload functionality.
- in a follow-up we will add options to reload.
2025-10-24 09:00:04 +00:00
b427392392
feat: add a press_key tool ( #458 )
...
Press key can be used to test shortcuts and individual key presses.
2025-10-23 16:18:58 +00:00
0fe2b8a2b4
feat: allow configuring tool categories ( #454 )
...
This PR introduces a feature to disable some of the MCP server tool
categories to tailor it to specific use cases.
For example,
```
npx chrome-devtools-mcp@latest --no-category-emulation Disable tools in the emulation category
npx chrome-devtools-mcp@latest --no-category-performance Disable tools in the performance category
npx chrome-devtools-mcp@latest --no-category-network Disable tools in the network category
```
2025-10-22 12:32:16 +02:00
92055933dc
feat: tool to get a verbose single console message ( #435 )
2025-10-20 11:18:41 +02:00
c7733a8180
docs: Update Copilot CLI instructions ( #423 )
...
This PR addresses issue #359 and updates instructions for Copilot CLI.
It removes the argument section and combines it with the command field.
2025-10-18 08:00:52 +02:00
41d6a107ba
feat: add WebSocket endpoint and custom headers support ( #404 )
...
## Summary
Add support for connecting to Chrome via WebSocket endpoint with custom
headers, enabling authenticated remote debugging scenarios and providing
an alternative to the HTTP-based connection method.
## What's New
This PR introduces two new CLI arguments:
- **`--wsEndpoint` / `-w`**: Connect directly to Chrome using a
WebSocket URL
- Example: `ws://127.0.0.1:9222/devtools/browser/<id>`
- Alternative to `--browserUrl` (mutually exclusive)
- **`--wsHeaders`**: Pass custom headers for WebSocket connections (JSON
format)
- Example: `'{"Authorization":"Bearer token"}'`
- Only works with `--wsEndpoint`
## Use Cases
- **Authenticated remote debugging**: Use API keys, tokens, or custom
auth headers
- **Secured instances**: Connect to browser instances requiring
authentication
2025-10-17 11:06:36 +02:00
9f9dab0787
docs: add VM-to-host remote debugging workaround ( #399 )
...
I think this part should be included in the document, I investigated it
for a long time at first, and it's not just me:
https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/328
https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/131
https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/139
2025-10-17 08:24:18 +02:00
d8df784127
docs: add instructions for Qoder ( #386 )
...
Adds instructions on how to add Chrome DevTools MCP to
[Qoder](https://qoder.com/ ).
<img width="790" height="770" alt="image"
src="https://github.com/user-attachments/assets/f35ea275-91c2-49af-a5a4-09539164187a "
/>
2025-10-16 06:59:01 +00:00
f415c3ec57
docs: add instructions for Kiro ( #347 )
...
Adds instructions on how to add Chrome DevTools MCP to
[Kiro](https://kiro.dev ).
<img width="706" height="449" alt="image"
src="https://github.com/user-attachments/assets/dab524b9-e684-4726-8f80-bffdfb3197cf "
/>
2025-10-12 17:44:21 +02:00
4ca045f9c6
docs: add Amp configuration to MCP client setup docs ( #343 )
...
Tool's website: https://ampcode.com
---------
Co-authored-by: Alex <alexei.rudenko@gmail.com >
2025-10-12 14:49:03 +00:00
070e88cd63
docs: update browser URL from localhost to 127.0.0.1 ( #342 )
...
Chrome only listens on IPv4 and localhost might resolve to an IPv6 in
some environments.
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/341
2025-10-11 21:15:10 +02:00
e1b5363653
feat: support passing args to Chrome ( #338 )
...
Drive-by: removes custom devtools frontend as a dedicated argument.
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/261
2025-10-10 15:05:41 +00:00
1674c09f05
docs: Add step-by-step guide for connecting to running Chrome instance ( #140 ) ( #330 )
2025-10-10 16:09:39 +02:00
4892a6e3a7
docs: fix arg name typo ( #327 )
2025-10-10 07:11:36 +00:00
0c3b019b49
docs: fix typo in save configuration shortcut ( #307 )
2025-10-08 09:00:23 +00:00
357db65d18
fix: change default screen size in headless ( #299 )
...
Sets the screen size in headless to be 3840x2160px to allow resize tool
to work correctly for most use cases.
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/294
2025-10-07 13:27:23 +00:00
3b197bccb0
docs: fix macOS typo ( #263 )
...
Fix the typo, rename MacOS to MacOS.
2025-10-07 09:06:55 +02:00
2714158eb3
docs: fix typos ( #260 )
...
This also implements the suggestion from
https://github.com/ChromeDevTools/chrome-devtools-mcp/pull/244
but that includes other parts that I am not sure we would want for now.
2025-10-02 16:59:09 +02:00
1de509eb87
docs: add instructions for Warp ( #253 )
...
Adds instructions on how to add Chrome DevTools MCP to Warp.
<img width="797" height="485" alt="Screenshot 2025-10-02 at 12 34 28"
src="https://github.com/user-attachments/assets/a62aa05d-512c-468e-86f8-41ce56357600 "
/>
Co-authored-by: Sebastian Benz <sbenz@google.com >
2025-10-02 14:36:11 +00:00
639d57d682
docs: update README.md typo ( #251 )
2025-10-02 11:35:18 +02:00
efb106dc94
feat: support --accept-insecure-certs CLI ( #231 )
...
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/155
Exposes the Puppeteer option only for the instances launched by the MCP
to avoid changing behavior for instances started by other means.
2025-10-01 10:21:05 +02:00
dfacc75ee9
feat: support --proxy-server CLI ( #230 )
...
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/155
2025-10-01 10:15:32 +02:00
ef61a08707
feat: support initial viewport in the CLI ( #229 )
...
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/165
This PR uses page_resize logic to set the initial viewport size. Not
using the emulation because it looks buggy in headful which is our
default mode.
2025-10-01 10:11:35 +02:00
a9fc8636fc
docs: add troubleshooting.md ( #226 )
...
starting a doc with troubleshooting tips
---------
Co-authored-by: Sebastian Benz <sbenz@google.com >
2025-10-01 09:52:09 +02:00
164933670d
docs: Add instructions for Copilot CLI ( #227 )
...
Fixes #180
2025-09-30 18:33:19 +00:00
6947581760
docs(getting-started): add npx -y to mcpServers args to auto-confirm install ( #215 )
...
Avoids the "Need to install ... Ok to proceed?" interaction so the setup
is non-interactive
for CI and first-time runs. (`-y` == `--yes`)
---------
Co-authored-by: Sebastian Benz <sebastian.benz@gmail.com >
2025-09-30 15:17:38 +02:00
760f6f1a9f
docs: add Visual Studio installation instructions ( #173 )
...
Added installation instructions for Visual Studio.
> Note, I'm a PM on the Visual Studio team and this way of installing
MCP servers into VS is the recommended way
2025-09-29 18:56:40 +02:00
4cf92cb54b
docs: add instructions for codex on windows ( #207 )
2025-09-29 16:03:16 +02:00
13613b4a33
fix: support node20 ( #52 )
...
Initially, we started with the support of Node22+ but since Node20 is an
LTS that is still in the maintenance mode it makes sense to support it.
2025-09-29 13:43:35 +00:00
eaecc2448c
docs: improved instructions for Gemini CLI MCP server ( #161 )
...
Added CLI installation instructions for Chrome DevTools MCP server using
Gemini CLI.
---------
Co-authored-by: Alex Rudenko <alexrudenko@chromium.org >
2025-09-26 13:24:18 +00:00
22ec7ee45c
fix: expose --debug-file argument ( #164 )
2025-09-26 09:00:04 +00:00
b3daa4899b
docs: add JetBrains AI Assistant and Junie ( #126 )
...
JetBrains AI Assistant and Junie also support MCP, this PR describes the
necessary configuration.
---------
Co-authored-by: Sebastian Benz <sebastian.benz@gmail.com >
Co-authored-by: Sebastian Benz <sbenz@google.com >
2025-09-25 12:31:28 +02:00
e5b6600022
docs: fix readme ( #122 )
...
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/pull/119
2025-09-24 14:48:15 +00:00
adfcecf987
fix: validate and report incompatible Node versions ( #113 )
...
Ref https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/92
2025-09-24 14:45:27 +02:00
Sebastian Benz