# Firefox Css Theme

> Firefox Css Theme is an open-source MCP server for developer tools. Build, inspect and live-debug Firefox CSS themes by inspecting the browser UI. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Repository:** https://github.com/easonwong-de/firefox-css-theme
- **MCP Registry name:** io.github.easonwong-de/firefox-css-theme
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [browser automation](https://ai-powered.com/categories/browser-automation)
- **Listing updated:** 2026-11-18

## About

The package is a toolkit for authoring Firefox userChrome and userContent themes, and its MCP server lets an assistant work on the browser's own interface. The assistant launches Firefox with chrome debugging, dumps the UI element tree, queries elements by CSS selector, reads computed styles, injects or removes stylesheets live and captures screenshots of a specific UI component. It can also run JavaScript in the browser chrome window, which is powerful and worth treating with care.

Outside MCP, the CLI scaffolds a theme project, starts Firefox with hot-reloading of stylesheets from the project root, and installs compiled CSS into a chosen profile. The README warns that installing overwrites existing CSS themes in the profile unless the merge flag is used and advises a backup first. Options cover a custom Firefox binary, profile name, headless mode and an adaptive tab bar colour add-on.

It needs Node.js and runs through npx over stdio.

## Features

- **UI tree inspection:** Dumps the DOM tree of Firefox's own interface.
- **Computed style lookup:** Reads the final CSS values of a chosen element.
- **Live CSS injection:** Adds, lists and removes stylesheets in the running browser.
- **UI screenshots:** Captures a specific interface component.
- **Hot-reload workflow:** The CLI rebuilds and reloads theme CSS as files change.
- **Theme scaffolding:** Creates a project for userChrome, userContent or both.

## Good for

- Debug why a toolbar element is styled wrongly
- Try a CSS tweak live before saving it to a theme
- Screenshot a part of the Firefox UI after a change
- Create and install a new Firefox theme project

## Install

### Claude Code (Terminal)

```sh
claude mcp add firefox-css-theme -- npx -y firefox-css-theme
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "firefox-css-theme": {
      "command": "npx",
      "args": [
        "-y",
        "firefox-css-theme"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "firefox-css-theme": {
      "command": "npx",
      "args": [
        "-y",
        "firefox-css-theme"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "firefox-css-theme": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "firefox-css-theme"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "firefox-css-theme": {
      "command": "npx",
      "args": [
        "-y",
        "firefox-css-theme"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "firefox-css-theme": {
      "command": "npx",
      "args": [
        "-y",
        "firefox-css-theme"
      ]
    }
  }
}
```

## Tools

- `launch_browser`: Launches Firefox with chrome debugging
- `close_browser`: Terminates the browser instance
- `customize_toolbar`: Toggles Customise Toolbar mode
- `get_ui_tree`: Dumps the DOM tree of the selected UI element
- `query_ui_elements`: Queries elements matching a CSS selector in browser chrome
- `get_computed_styles`: Extracts computed CSS values of a UI element
- `inject_theme_css`: Injects a stylesheet into the live UI
- `remove_theme_css`: Removes an injected stylesheet
- `list_theme_css`: Lists injected stylesheets
- `take_ui_screenshot`: Captures a screenshot of a UI component
- `execute_chrome_javascript`: Runs JavaScript in the browser chrome context

## FAQ

### What does it need?

Node.js; it runs via npx -y firefox-css-theme mcp.

### Will installing overwrite my theme?

Yes, unless you pass --merge; the README advises a backup.

### Can it run Firefox without a window?

Yes, the start command has a headless option.

### Which clients work?

Claude Code, Codex and any MCP client that can launch a stdio server.

### Is Firefox Css Theme free?

Yes. Firefox Css Theme is open source, so you can use and self-host it for free.

### How do I add Firefox Css Theme to Claude Code?

Run this command in your terminal: claude mcp add firefox-css-theme -- npx -y firefox-css-theme

### What are the best alternatives to Firefox Css Theme?

The closest alternatives to Firefox Css Theme are REA, Browser Use, Scrapling MCP Server, Context7 and Chrome DevTools MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/firefox-css-theme
