Skip to content
MCP server

FoxMCP

Let an AI assistant use your real, logged-in Firefox: tabs, pages, bookmarks and history

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
firefox-extension, CLI, Linux
Runs
Locally
Version
1.7.0
Listing updated
today

Similar MCP servers

About FoxMCP

FoxMCP is an open-source MCP server for browser automation. It runs locally on your machine and is started by your AI client.

FoxMCP has two parts: a Firefox extension, installed from Firefox Add-ons, and a local Python server started by your MCP client with uvx foxmcp --stdio. The extension connects to the server over WebSocket on port 8765, so the agent works inside the browser you already use, with its logins, cookies, containers and several profiles.

The README compares it with Mozilla's firefox-devtools-mcp. FoxMCP suits working in your own session and sharing one Firefox between several agents (start each with --single-instance); the devtools server starts a clean browser and is better for console, network, debugger and profiler work, and for Android.

Capabilities cover profiles, tabs and tab groups, windows, reading page text or HTML, running JavaScript and bundled scripts, uploading local files, bookmarks, history, and monitoring network requests. Every browser tool needs a profile_id from profiles_list. The README warns that a connected client can reach anything you can, and suggests a dedicated Firefox profile.

Install

Run in a terminal

claude mcp add foxmcp -- uvx foxmcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "foxmcp": {
      "command": "uvx",
      "args": [
        "foxmcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "foxmcp": {
      "command": "uvx",
      "args": [
        "foxmcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "foxmcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "foxmcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "foxmcp": {
      "command": "uvx",
      "args": [
        "foxmcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "foxmcp": {
      "command": "uvx",
      "args": [
        "foxmcp"
      ]
    }
  }
}

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

What it does

Your own Firefox
Acts in the browser you already run, logins included.
Tabs and windows
List, open, close, move, group and resize.
Page reading and scripts
Read text or HTML, run JavaScript or predefined scripts.
Bookmarks and history
Search, create, update and delete.
Network inspection
Monitor requests by URL pattern and view headers and text bodies.
Multiple agents
A single-instance mode lets several clients share one Firefox.

Good for

  • Tidy and group open tabs before a meeting
  • Read the text of a logged-in page for an assistant
  • Organise bookmarks with an AI
  • Upload a local file to a web form
  • Inspect network requests a page makes

Pricing

Open source

Open source on GitHub and PyPI

FoxMCP FAQ

What do I need?

Firefox with the extension, an MCP client and uv; Python 3.10 or newer.

Is it safe?

The README warns that connected clients can access browser data and run page scripts, so use trusted clients and consider a dedicated profile.

How does it differ from firefox-devtools-mcp?

FoxMCP works in your existing session; firefox-devtools-mcp starts its own clean Firefox and offers debugger and profiler tools.

Are tab groups supported?

Native tab groups need Firefox 139 or newer.

Is FoxMCP free?

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

How do I add FoxMCP to Claude Code?

Run this command in your terminal: claude mcp add foxmcp -- uvx foxmcp

What are the best alternatives to FoxMCP?

The closest alternatives to FoxMCP are Browser Use, Scrapling MCP Server, Chrome DevTools MCP, Oya Browser and playwright_mcp.

Where this comes from

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

How AIPoweredBot checks servers