Firefox
Provides Firefox browser automation capabilities through Playwright, allowing control of Firefox from MCP-enabled applications with features for basic automation and advanced multi-tab debugging.
What is Firefox?
Firefox is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides firefox browser automation capabilities through playwright, allowing control of firefox from mcp-enabled applications with features for basic automation and advanced multi-tab debugging.
Provides Firefox browser automation capabilities through Playwright, allowing control of Firefox from MCP-enabled applications with features for basic automation and advanced multi-tab debugging.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Provides Firefox browser automation capabilities through Pla
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx firefox-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Firefox
The Firefox MCP server provides full browser automation capabilities by controlling Firefox through Playwright, and exposes 28 tools covering everything from navigation and element interaction to multi-session management and deep debugging. Unlike generic Playwright wrappers, it includes a specialized debugging suite that captures real-time console output, JavaScript errors, network traffic, WebSocket messages, and performance metrics — making it particularly valuable for testing complex web applications and AI-driven browsing workflows.
Prerequisites
- Node.js 18.0.0 or later
- Firefox browser (automatically installed via Playwright during setup)
- An MCP-compatible client such as Claude Desktop or Claude Code
Install the npm package
Install the firefox-mcp-server package from npm globally or into a local project.
npm install firefox-mcp-serverInstall the Firefox browser via Playwright
The package uses Playwright to drive Firefox. Run the Playwright browser installer to download the Firefox binary.
npx playwright install firefoxAdd to Claude Desktop configuration
Edit your Claude Desktop config file to register the Firefox MCP server using npx.
{
"mcpServers": {
"firefox": {
"command": "npx",
"args": ["firefox-mcp-server"]
}
}
}Restart Claude Desktop
Restart Claude Desktop to load the server. You should see 'firefox' listed as an available MCP server in the interface.
Test with a basic navigation command
Ask Claude to open a URL to verify the browser automation is working end-to-end.
Firefox Examples
Client configuration
Claude Desktop JSON configuration for the Firefox MCP server using npx.
{
"mcpServers": {
"firefox": {
"command": "npx",
"args": ["firefox-mcp-server"]
}
}
}Prompts to try
Example tasks you can ask Claude to perform with the Firefox MCP server connected.
- "Open Firefox, navigate to https://example.com, and take a screenshot"
- "Launch two Firefox sessions — one as user1 and one as user2 — both pointing to https://myapp.com"
- "Go to https://myapp.com, click the Login button, type 'testuser' into the username field, and capture any console errors"
- "Monitor WebSocket messages on https://myapp.com for the next 30 seconds"
- "Navigate to https://myapp.com, run document.title in the browser console, and return the result"Troubleshooting Firefox
Error: browserType.launch: Failed to launch — browser not found
Run the Playwright Firefox installer: 'npx playwright install firefox'. If that doesn't work, try './node_modules/.bin/playwright install firefox' from the project directory where firefox-mcp-server is installed.
Server starts but Claude cannot control the browser — commands time out
Make sure Firefox is not already open with a conflicting Playwright profile. Restart both Claude Desktop and any existing Firefox instances. If running headlessly on a server, ensure a display is available (e.g. Xvfb on Linux) or that headless mode is not blocked by site bot-detection.
Multi-session tool calls fail or sessions interfere with each other
Each session should be created with a unique sessionId string. Call session_create with distinct IDs before issuing per-session commands. Use list active sessions to confirm session state before issuing further commands.
Frequently Asked Questions about Firefox
What is Firefox?
Firefox is a Model Context Protocol (MCP) server that provides firefox browser automation capabilities through playwright, allowing control of firefox from mcp-enabled applications with features for basic automation and advanced multi-tab debugging. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Firefox?
Follow the installation instructions on the Firefox GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Firefox?
Firefox works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Firefox free to use?
Yes, Firefox is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Firefox Alternatives — Similar Browser Automation Servers
Looking for alternatives to Firefox? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Firefox in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Firefox?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.