Skip to main content
Glama

🦊 FoxDen MCP

Let your AI agent use your Firefox: your logins, saved passwords, bookmarks and extensions.

FoxDen is an MCP server for AI agents (Claude, Cursor, VS Code, ...). It has every tool and option of Playwright MCP, but it drives the Firefox already installed on your computer, not a fresh Chrome with no logins. FoxDen copies your real Firefox profile into its own "den", so the agent starts out signed in to your sites, and your everyday Firefox is never touched.

  • Same tools: navigate, click, type, fill forms, snapshots, screenshots, tabs, network, PDF, vision, devtools, and every other Playwright MCP tool and command-line flag.

  • Your sessions: cookies, saved passwords (with autofill), bookmarks and extensions come along.

  • Safe for your daily browser: FoxDen works on a copy. Your real profile is never modified or locked, and you can keep browsing in Firefox while the agent works.

  • Multiple accounts: keep a separate profile per client or account and switch with one command.

Requirements

  • Node.js 18 or newer

  • Firefox (a recent release; checked with foxden doctor)

  • Windows, macOS or Linux

Related MCP server: marionette-mcp

Install

git clone https://github.com/itbitez/foxden-mcp.git
cd foxden-mcp
npm install
npm link           # optional: makes the "foxden" command available everywhere

Copy your Firefox profile into FoxDen and check the setup:

foxden clone       # or: npm run foxden -- clone
foxden doctor

Add it to your MCP client

Run foxden setup to print the exact config with your local path. For example:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "foxden": {
      "command": "node",
      "args": ["C:/path/to/foxden-mcp/bin/foxden-mcp.js"]
    }
  }
}

Claude Code:

claude mcp add --scope user foxden -- node "C:/path/to/foxden-mcp/bin/foxden-mcp.js"

VS Code / Cursor / others: use the same command and args.

Profiles

Command

What it does

foxden list

Show your Firefox profiles and FoxDen profiles

foxden clone

Copy your default Firefox profile into the main FoxDen profile (run again to refresh)

foxden clone <firefox-profile> --as <name>

Copy a specific Firefox profile under another name

foxden clone --light

Copy without site storage (smaller), keeping cookies and passwords

foxden new <name>

Create an empty profile, for example for a second account

foxden login [name] [url]

Open a normal Firefox window with that profile to sign in by hand

foxden use <name>

Choose the profile FoxDen MCP uses

foxden remove <name>

Delete a FoxDen profile (your real Firefox is untouched)

foxden doctor

Check Node.js, Firefox and the active profile

foxden setup [name]

Print the MCP client config

Signing in to a site

  1. Ask the agent to close the browser (or close the FoxDen Firefox window).

  2. Run foxden login, sign in, then close the window.

  3. Next time the agent opens the browser, it is already signed in.

Sign in by hand rather than letting the agent do it. Some sites, like Google, refuse to sign in while a browser is being automated.

Several accounts at once

foxden new client-a
foxden login client-a https://example.com/login

Then run one server per profile:

{
  "mcpServers": {
    "foxden": { "command": "node", "args": ["C:/path/to/foxden-mcp/bin/foxden-mcp.js"] },
    "foxden-client-a": { "command": "node", "args": ["C:/path/to/foxden-mcp/bin/foxden-mcp.js", "--profile", "client-a"] }
  }
}

Options

FoxDen passes every Playwright MCP option straight through, so --headless, --caps=vision,pdf,devtools, --viewport-size, --proxy-server, --config, --port and the rest work exactly as documented in the Playwright MCP README. If you pass your own --config file, it is merged on top of FoxDen's Firefox defaults.

FoxDen adds:

Option / variable

Meaning

--profile <name> / FOXDEN_PROFILE

Profile to use (default: the one chosen with foxden use, else main)

FIREFOX_PATH

Path to the Firefox executable if it is not in a standard location

FOXDEN_HOME

Where profiles are stored (default below)

Profiles are stored in:

  • Windows: %LOCALAPPDATA%\FoxDen\profiles

  • macOS: ~/Library/Application Support/FoxDen/profiles

  • Linux: ~/.local/share/foxden/profiles

Chrome-only modes (--extension, --cdp-endpoint) and --browser chrome|msedge|webkit still work. FoxDen then runs as plain Playwright MCP without a FoxDen profile. --mobile is not available with Firefox.

How it works

  • FoxDen starts Playwright MCP with --browser moz-firefox. Playwright then controls your installed Firefox over WebDriver BiDi, Firefox's standard automation protocol, so no patched browser download is needed.

  • Your profile is copied, never used directly. Firefox locks a profile while it runs, and Playwright writes automation prefs into whatever profile it opens.

  • Playwright turns off password saving/autofill and safe browsing for testing. FoxDen turns them back on (lib/firefox-config.json).

Troubleshooting

  • Browser does not start: run foxden doctor. The most common cause is a foxden login window still open with the same profile.

  • Not signed in somewhere: run foxden clone again to refresh the copy from your Firefox (close Firefox first for the cleanest copy), or sign in with foxden login. Cloning replaces logins you made inside the copy.

  • Primary Password: if you use one, Firefox asks for it before filling saved passwords.

Test

npm test                                  # tool parity with Playwright MCP + launches Firefox
npm test -- --caps=vision,pdf,devtools    # with optional tool groups

Security

Profiles contain your cookies and saved passwords. They live outside this repository and are git-ignored. Never share or commit a profile folder. Anyone with the agent's browser can act as you on signed-in sites.

License

MIT © itbitez. See LICENSE.

FoxDen uses Playwright MCP by Microsoft (Apache-2.0) as an unmodified dependency; see NOTICE. FoxDen is not affiliated with Microsoft or Mozilla.

Available Tools

25 tools
browser_clickB
Destructive

Perform click on a web page

Inputs: target (required), button, element, modifiers, +1 more.

browser_closeB
Destructive

Close the page

Inputs: no named parameters.

browser_console_messagesC
Read-only

Returns all console messages

Inputs: level (required), all, filename.

browser_dragA
Destructive

Perform drag and drop between two elements

Inputs: endTarget (required), startTarget (required), endElement, startElement.

browser_dropA
Destructive

Drop files or MIME-typed data onto an element, as if dragged from outside the page. At least one of "paths" or "data" must be provided.

Inputs: target (required), data, paths, element.

browser_emulate_mediaA
Destructive

Emulate CSS media features for the page, for example switch between the light and dark color scheme. Omitted parameters are left unchanged; null clears an override.

Inputs: media, contrast, colorScheme, forcedColors, +1 more.

browser_evaluateC
Destructive

Evaluate JavaScript expression on page or element

Inputs: function (required), target, element, filename.

browser_file_uploadB
Destructive

Upload one or multiple files

Inputs: paths.

browser_fill_formB
Destructive

Fill multiple form fields

Inputs: fields (required).

browser_findA
Read-only

Search the accessibility snapshot of the current page for text or a regular expression. Returns matching snapshot nodes with a few lines of surrounding context (like search snippets), each shown under its path from the root of the tree, which is cheaper than capturing the whole snapshot when you only need to locate an element and its ref.

Inputs: text, regex, filename.

browser_handle_dialogC
Destructive

Handle a dialog

Inputs: accept (required), promptText.

browser_hoverA
Destructive

Hover over element on page

Inputs: target (required), element.

browser_navigateC
Destructive

Navigate to a URL

Inputs: url (required).

browser_navigate_backA
Destructive

Go back to the previous page in the history

Inputs: no named parameters.

browser_network_requestA
Read-only

Returns full details (headers and body) of a single network request, or a single part if part is set. Use the number from browser_network_requests.

Inputs: index (required), part, filename.

browser_network_requestsA
Read-only

Returns a numbered list of network requests since loading the page. Use browser_network_request with the number to get full details.

Inputs: static (required), filter, filename.

browser_press_keyB
Destructive

Press a key on the keyboard

Inputs: key (required).

browser_resizeB
Destructive

Resize the browser window

Inputs: width (required), height (required).

browser_run_code_unsafeA
Destructive

Run a Playwright code snippet. Unsafe: executes arbitrary JavaScript in the Playwright server process and is RCE-equivalent.

Inputs: code, filename.

browser_select_optionB
Destructive

Select an option in a dropdown

Inputs: target (required), values (required), element.

browser_snapshotA
Read-only

Capture accessibility snapshot of the current page, this is better than screenshot

Inputs: boxes, depth, target, filename.

browser_tabsA
Destructive

List, create, close, or select a browser tab.

Inputs: action (required), url, index.

browser_take_screenshotA
Read-only

Take a screenshot of the current page. You can't perform actions based on the screenshot, use browser_snapshot for actions.

Inputs: scale (required), type, target, element, +2 more.

browser_typeB
Destructive

Type text into editable element

Inputs: text (required), target (required), slowly, submit, +1 more.

browser_wait_forB
Read-only

Wait for text to appear or disappear or a specified time to pass

Inputs: text, time, textGone.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 25 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, and descriptions actively disambiguate near-pairs like browser_drop vs browser_drag and browser_network_requests vs browser_network_request. A few boundaries are fuzzy (browser_evaluate vs browser_run_code_unsafe, browser_snapshot vs browser_take_screenshot), but the descriptions steer selection well.

    Naming Consistency5/5

    Every tool uses the uniform browser_ snake_case prefix with a predictable verb/noun suffix (browser_navigate, browser_click, browser_select_option). There are no mixed conventions or stray naming styles.

    Tool Count4/5

    25 tools is at the heavy end, but this is a full browser-automation surface where each tool maps to a distinct Playwright capability, so most earn their place. It is slightly over what a minimal agent needs, but not padded.

    Completeness4/5

    The surface covers navigation, interaction, forms, tabs, network, console, dialogs, screenshots, and snapshots, which is strong lifecycle coverage. Minor gaps exist: no forward-history tool (only browser_navigate_back) and no cookie/storage or scrolling primitives.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      C
      maintenance
      Enables AI assistants to read and drive a real, logged-in Firefox browser, including tabs, cookies, history, and site interactions, all through the Model Context Protocol.
      52
      16 npm
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to drive a user-launched Firefox instance via its native Marionette protocol, providing precise DOM actuation like clicking, typing, uploading files, taking screenshots, and evaluating JavaScript.
      18
      23 npm
      1
      GPL 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for the Firefox you actually use: an add-on plus a small native helper, so an agent gets your real profile, tabs and logged-in sessions instead of a blank headless browser. 45 tools for tabs, accessibility snapshots with refs, clicking, typing, screenshots, bookmarks, history and downloads.
      9
      Mozilla Public 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to automate a privacy-focused Firefox-based browser through MCP, with session and profile management, navigation, interaction, extraction, screenshots, JavaScript execution, tabs, downloads, and permission/URL validation.
      MIT