Firefox Css Theme
Build, inspect and live-debug Firefox CSS themes by inspecting the browser UI
- 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-themeAdd to claude_desktop_config.json
{
"mcpServers": {
"firefox-css-theme": {
"command": "npx",
"args": [
"-y",
"firefox-css-theme"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"firefox-css-theme": {
"command": "npx",
"args": [
"-y",
"firefox-css-theme"
]
}
}
}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.


