Setup Guide

3 steps. 2 minutes.

Install Claudezilla and connect it to Claude Code. The installer auto-configures everything for you.

NEW v0.7.2 — bounded frame waits, adopted-window politeness, correct MCP registration

Quick Start

The installer configures everything automatically — MCP server, permissions, and dependencies.

Install Firefox Extension

Get Claudezilla from Mozilla Add-ons. Click the button above or search "Claudezilla" in Firefox.

Run Installer Auto-Config

Clone the repo and run the installer for your platform. It handles everything else.

git clone https://github.com/boot-industries/claudezilla.git
cd claudezilla
./install/install-macos.sh

git clone https://github.com/boot-industries/claudezilla.git
cd claudezilla
./install/install-linux.sh

# Run PowerShell as Administrator
git clone https://github.com/boot-industries/claudezilla.git
cd claudezilla
.\install\install-windows.ps1

✓

Native Messaging Host Connects Firefox extension to Claude Code

✓

MCP Server Registration Runs claude mcp add --scope user

✓

Tool Permissions Auto-allows the Claudezilla tools in settings.json

✓

Dependencies Installs npm packages for MCP server

Restart Claude Code

Close and reopen Claude Code (or run /mcp) to load the new MCP server. That's it!

# Verify connection in Claude Code
"Claude, take a screenshot of https://example.com"

If the installer couldn't auto-configure Claude Code, add these manually:

Register the MCP server

claude mcp add --scope user claudezilla -- node /path/to/claudezilla/mcp/server.js

~/.claude/settings.json

{
  "permissions": {
    "allow": [
      "mcp__claudezilla__firefox_click",
      "mcp__claudezilla__firefox_navigate",
      "mcp__claudezilla__firefox_screenshot"
    ]
  }
}

Replace /path/to/claudezilla with the actual path where you cloned the repo. The installer writes the full tool list (see install/claude-permissions.json). firefox_evaluate is not on it — add it by hand if you turn on JavaScript evaluation in the extension.

Enable Private Windows

Claudezilla uses private windows for isolation. Enable this permission for full functionality.

Open Extension Settings

Navigate to about:addons in Firefox and find Claudezilla.

Toggle Private Window Access

Click on Claudezilla, then enable "Run in Private Windows".

🦖

Claudezilla

by boot.industries

Run in Private Windows

This extension will be able to read and change data in private windows.

⚡ Why Private Windows?

Private windows provide isolation for browser automation. Your automation runs separately from your normal browsing. You can skip this, but some features will be limited.

Troubleshooting

🔧 Connection Issues?

Check the debug log at ~/.claudezilla/claudezilla-debug.log (macOS/Linux) or %LOCALAPPDATA%\claudezilla\claudezilla-debug.log (Windows). Make sure Firefox is running before starting Claude Code. Click the Claudezilla icon in Firefox to test the connection.

🔄 MCP Not Loading?

Run /mcp in Claude Code to reconnect. If Claudezilla isn't listed, run claude mcp get claudezilla to check the path to server.js, or re-register it with claude mcp add --scope user claudezilla -- node /path/to/claudezilla/mcp/server.js.

🔒 Permission Denied?

If Claude asks for permission on every tool call, ensure the tool name (for example mcp__claudezilla__firefox_click) is in your ~/.claude/settings.json allow list. The installer writes the full list. firefox_evaluate is never on it — add it by hand if you enable JavaScript evaluation in the extension.

☕ Support This Project

Claudezilla is free and open source. Your support helps keep it that way.

☕ Buy Me a Coffee

One-time or monthly contributions via Stripe