# Zen Devtools MCP

> Zen Devtools MCP is an open-source MCP server for browser automation. MCP wrapper that attaches AI clients to your already-running Zen or Firefox browser. It is available on macOS, CLI and API.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI, API
- **Repository:** https://github.com/sushruth/zen-devtools-mcp
- **MCP Registry name:** io.github.sushruth/zen-devtools-mcp
- **Categories:** [browser automation](https://ai-powered.com/categories/browser-automation)
- **Listing updated:** 2026-11-18

## About

The README says this wrapper exists because the upstream firefox-devtools-mcp connect mode needs the browser started with Marionette enabled, which ordinary relaunches don't do. When Marionette is not listening, the wrapper quits the browser gracefully, relies on session restore to bring tabs back, relaunches it with Marionette on, and then starts the MCP server.

It can be run directly from GitHub with npx or bunx, and it takes flags for the macOS app name, process name and Marionette port so Firefox or a custom port works too. A companion zen-devtools CLI runs a shared background daemon, so separate shell commands can reuse one browser connection and element uids from take_snapshot stay valid between them.

The project suits developers and agent users who want an AI client to drive the browser session they already have open, rather than a fresh throwaway instance. The README notes it is macOS-only because it relies on open, osascript and pgrep.

## Features

- **Attaches to running browser:** Connects to an existing Zen or Firefox session instead of launching a separate instance.
- **Automatic Marionette restart:** Restarts the browser with Marionette enabled when the port is not up, with session restore keeping tabs.
- **Configurable app and port:** Flags select the macOS app name, process name and Marionette port.
- **Shared CLI daemon:** A zen-devtools command runs one background daemon that serves commands from separate shells.
- **Persistent element uids:** Element uids from take_snapshot remain valid across separate CLI commands.

## Good for

- Letting an AI coding agent inspect the tabs you already have open in Zen or Firefox
- Running page navigation, snapshots and script evaluation from the terminal against a live browser
- Debugging a web page in your everyday browser profile without starting a clean instance
- Attaching a second Firefox-based browser to a separate MCP entry on another port

## FAQ

### Which operating systems does it support?

The README says it is macOS-only because it uses open, osascript and pgrep.

### Will I lose my open tabs when the wrapper restarts the browser?

The README says session restore preserves tabs across wrapper-triggered restarts.

### Do I need to install it before using it?

No. The README says it can be run straight from GitHub with npx or bunx, and the CLI installs itself on first use if missing from PATH.

### Is a browser restart needed the first time?

Yes. The README says Marionette cannot be enabled on a live browser process, so a restart is unavoidable the first time.

### Is Zen Devtools MCP free?

Yes. Zen Devtools MCP is open source, so you can use and self-host it for free.

### What are the best alternatives to Zen Devtools MCP?

The closest alternatives to Zen Devtools MCP are Brave DevTools MCP, Chrome DevTools MCP, Selenium MCP, Selenium Webdriver MCP and MCP Browser Extension.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.

## Alternatives

- [Brave DevTools MCP](https://ai-powered.com/mcp/brave-devtools-mcp): Brave DevTools MCP is an open-source MCP server for browser automation.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-4): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Selenium MCP](https://ai-powered.com/mcp/selenium-mcp-2): Selenium MCP is an open-source MCP server for browser automation.
- [Selenium Webdriver MCP](https://ai-powered.com/mcp/selenium-webdriver-mcp): Selenium Webdriver MCP is an open-source MCP server for browser automation.
- [MCP Browser Extension](https://ai-powered.com/mcp/mcp-browser-extension): MCP Browser Extension is an open-source MCP server for browser automation.
- [playwright_mcp](https://ai-powered.com/mcp/playwright-mcp-3): playwright_mcp is an open-source MCP server for browser automation.
- [MCP Browser](https://ai-powered.com/mcp/mcp-browser-3): MCP Browser is an open-source MCP server for browser automation.
- [Glovebox MCP](https://ai-powered.com/mcp/glovebox-mcp): Glovebox MCP is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/zen-devtools-mcp
