Repolode
Submit
mozilla

mozilla/firefox-devtools-mcp

MCP server that lets AI agents browse and inspect Firefox through WebDriver BiDi, for agentic browsing and developer-tool debugging.

View on GitHub
Stars
553
Forks
76
Open issues
10
Last commit
3 days ago

What is it?

Firefox DevTools MCP is a Model Context Protocol server that gives AI assistants control over a local Firefox browser. It is built on WebDriver BiDi through Selenium WebDriver, and works with MCP clients such as Claude Code, Claude Desktop, Cursor and Cline.

The project covers two main scenarios. The first is agentic browsing, where the agent reads pages, fills forms and completes multi-step flows on websites. The second is agent-assisted web development, where the agent loads the page you are working on and inspects it with console messages, network requests, the debugger and the profiler.

Tools are grouped into modules and exposed through presets from `slim` to `all`, so you can limit what the agent can do. It also supports headless mode, custom profiles, attaching to an already running Firefox, and Firefox for Android via ADB. Because the agent can reach whatever the browser can, the project recommends a dedicated Firefox profile.

Key features

  • 01Controls Firefox through WebDriver BiDi via Selenium WebDriver.
  • 02Takes page snapshots and clicks or fills elements by UID.
  • 03Captures network requests, console messages and downloads.
  • 04Offers tool presets that limit which capabilities the agent gets.
  • 05Supports headless mode, custom profiles and attaching to a running Firefox.
  • 06Can automate Firefox for Android over ADB.

Use cases

  • Letting an AI agent complete multi-step tasks such as form filling on websites.
  • Having an AI assistant inspect the page you are developing, including console and network output.
  • Profiling or debugging a web page in Firefox from an MCP-compatible coding assistant.
  • Automating Firefox for Android test sessions from a desktop machine.

Quick start

  1. 1

    Make sure Node.js 20.19.0 or newer and Firefox 100+ are installed

  2. 2

    Run the server locally with npx

    npx @mozilla/firefox-devtools-mcp@latest
  3. 3

    Register it with Claude Code

    claude mcp add firefox-devtools npx @mozilla/firefox-devtools-mcp@latest

Things to know

  • Requires a local Firefox installation and cannot run on cloud hosting services.
  • Use a dedicated Firefox profile, since the agent can access cookies and saved sessions.
  • Android mode wipes all data of the target app before every session.
  • The license is listed as NOASSERTION in the metadata, so check the license files before use.

In collections

Browser automation for AI agentsMCP servers for Claude CodeClaude Code tools, skills & pluginsOpen-source AI agent frameworks & appsMCP servers

Topics

#mcp#firefox#webdriver-bidi#browser-automation#ai-agent#devtools#selenium#claude-code#mcp-server

FAQ

What is firefox-devtools-mcp?
MCP server that lets AI agents browse and inspect Firefox through WebDriver BiDi, for agentic browsing and developer-tool debugging. Firefox DevTools MCP is a Model Context Protocol server that gives AI assistants control over a local Firefox browser. It is built on WebDriver BiDi through Selenium WebDriver, and works with MCP clients such as Claude Code, Claude Desktop, Cursor and Cline.
Is firefox-devtools-mcp free to use? What license does it have?
firefox-devtools-mcp is open source under the Other license. Check the license terms before using it in commercial products.
Is firefox-devtools-mcp still maintained?
Actively maintained. The last commit to firefox-devtools-mcp was on Nov 4, 2026.
What can I use firefox-devtools-mcp for?
Letting an AI agent complete multi-step tasks such as form filling on websites. Having an AI assistant inspect the page you are developing, including console and network output. Profiling or debugging a web page in Firefox from an MCP-compatible coding assistant. Automating Firefox for Android test sessions from a desktop machine.
How do I install firefox-devtools-mcp?
Make sure Node.js 20.19.0 or newer and Firefox 100+ are installed Run the server locally with npx: npx @mozilla/firefox-devtools-mcp@latest Register it with Claude Code: claude mcp add firefox-devtools npx @mozilla/firefox-devtools-mcp@latest
Where can I get firefox-devtools-mcp?
The source code and installation instructions are on GitHub: https://github.com/mozilla/firefox-devtools-mcp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects