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
cb17ae80e6
docs: add Codex MCP configuration guide ( #95 )
...
Co-authored-by: Sebastian Benz <sbenz@google.com >
2025-09-24 08:48:06 +02:00
1ed7e45fef
docs: explain when the browser starts ( #89 )
2025-09-23 20:13:03 +00:00
85a6d640f7
docs: small README wording tweaks ( #67 )
2025-09-22 14:38:58 +00:00
bfbdada6c7
docs: document mcp client sandboxing ( #65 )
...
Co-authored-by: Sebastian Benz <sbenz@google.com >
2025-09-22 14:16:44 +00:00
8ce4888611
docs: improve Cursor install instructions ( #58 )
...
Adds an install to cursor button (also fixes windows support in docs
generation).
2025-09-22 09:35:07 +00:00
a6923b8d93
fix: fix browserUrl not working ( #53 )
...
Setting the default channel in the CLI resulted in our mutually
exclusive check for browserUrl and channel to fail.
2025-09-19 12:24:05 +02:00
21e175b862
feat: add performance_analyze_insight tool. ( #42 )
2025-09-17 12:25:40 +00:00
36115d757a
fix: change profile folder name to browser-profile ( #39 )
2025-09-16 14:49:05 +00:00
b8d99a6edb
docs: add npm badge ( #35 )
2025-09-16 07:16:37 +00:00
c992874111
docs: update readme ( #18 )
...
Co-authored-by: Sebastian Benz <sebastian.benz@gmail.com >
2025-09-15 09:56:54 +02:00
0d6ec035f7
docs: fix links and mcp config name ( #14 )
...
- "chrome-devtools-mcp" with "chrome-devtools" as the server name in the
configs.
- sorted by alphabet for easier lookup
- fixed markdown links in details
Rendered:
https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/e7c4d9a306e841e98bffeecc11182708f234d8d8/README.md
2025-09-12 15:17:14 +02:00
8ba8460b98
docs: polish readme ( #2 )
...
* add configuration section
* move user-data-dir to new concepts section
2025-09-12 12:30:30 +02:00
d89d593e22
chore: re-wrap cli ( #4 )
2025-09-11 13:30:26 +02:00
31a0bdce26
feat: initial version
2025-09-11 12:46:05 +02:00
Alex Rudenko