Setup Guide

3 steps. 2 minutes.

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

NEW v0.5.8 — macOS install fixes

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 Auto-adds to ~/.claude/mcp.json

✓

Tool Permissions Auto-allows mcp__claudezilla__* 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:

~/.claude/mcp.json

{
  "mcpServers": {
    "claudezilla": {
      "command": "node",
      "args": ["/path/to/claudezilla/mcp/server.js"]
    }
  }
}

~/.claude/settings.json

{
  "permissions": {
    "allow": ["mcp__claudezilla__*"]
  }
}

Replace /path/to/claudezilla with the actual path where you cloned the repo.

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 /tmp/claudezilla-debug.log (macOS/Linux) or %TEMP%\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, check that ~/.claude/mcp.json has the correct path to server.js.

🔒 Permission Denied?

If Claude asks for permission on every tool call, ensure mcp__claudezilla__* is in your ~/.claude/settings.json allow list.

☕ 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