# FoxMCP

> FoxMCP is an open-source MCP server for browser automation. Let an AI assistant use your real, logged-in Firefox: tabs, pages, bookmarks and history. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** firefox-extension, CLI, Linux, macOS, Windows
- **Repository:** https://github.com/thinkeryzu/foxmcp
- **MCP Registry name:** io.github.ThinkerYzu/foxmcp
- **Categories:** [browser automation](https://ai-powered.com/categories/browser-automation)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add foxmcp -- uvx foxmcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "foxmcp": {
      "command": "uvx",
      "args": [
        "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.

## Alternatives

- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [playwright_mcp](https://ai-powered.com/mcp/playwright-mcp-3): playwright_mcp is an open-source MCP server for browser automation.
- [browsentic](https://ai-powered.com/mcp/browsentic-2): browsentic is an open-source MCP server for browser automation.
- [Turbo-Browser-MCP](https://ai-powered.com/mcp/turbo-browser-mcp): Turbo-Browser-MCP is an open-source MCP server for browser automation.
- [Mantis](https://ai-powered.com/mcp/mantis-2): Mantis is an open-source MCP server for browser automation.

---
Source: https://ai-powered.com/mcp/foxmcp
