Skip to content
MCP server

Firefox Css Theme

Build, inspect and live-debug Firefox CSS themes by inspecting the browser UI

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.3.5
Listing updated
today

Similar MCP servers

About Firefox Css Theme

Firefox Css Theme is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "firefox-css-theme": {
      "command": "npx",
      "args": [
        "-y",
        "firefox-css-theme"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "firefox-css-theme": {
      "command": "npx",
      "args": [
        "-y",
        "firefox-css-theme"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free open source

Firefox Css Theme 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.

How AIPoweredBot checks servers