FoxDen MCP
Drives the user's installed Firefox browser over WebDriver BiDi, using a copy of their real Firefox profile so agents start signed in with cookies, saved passwords, bookmarks, and extensions, while leaving their everyday Firefox untouched.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FoxDen MCP Check my GitHub notifications using my saved login and summarize them"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🦊 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
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 everywhereCopy your Firefox profile into FoxDen and check the setup:
foxden clone # or: npm run foxden -- clone
foxden doctorAdd 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 |
| Show your Firefox profiles and FoxDen profiles |
| Copy your default Firefox profile into the |
| Copy a specific Firefox profile under another name |
| Copy without site storage (smaller), keeping cookies and passwords |
| Create an empty profile, for example for a second account |
| Open a normal Firefox window with that profile to sign in by hand |
| Choose the profile FoxDen MCP uses |
| Delete a FoxDen profile (your real Firefox is untouched) |
| Check Node.js, Firefox and the active profile |
| Print the MCP client config |
Signing in to a site
Ask the agent to close the browser (or close the FoxDen Firefox window).
Run
foxden login, sign in, then close the window.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/loginThen 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 to use (default: the one chosen with |
| Path to the Firefox executable if it is not in a standard location |
| Where profiles are stored (default below) |
Profiles are stored in:
Windows:
%LOCALAPPDATA%\FoxDen\profilesmacOS:
~/Library/Application Support/FoxDen/profilesLinux:
~/.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 afoxden loginwindow still open with the same profile.Not signed in somewhere: run
foxden cloneagain to refresh the copy from your Firefox (close Firefox first for the cleanest copy), or sign in withfoxden 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 groupsSecurity
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 toolsbrowser_clickBDestructive
Perform click on a web page
Inputs: target (required), button, element, modifiers, +1 more.
browser_closeBDestructive
Close the page
Inputs: no named parameters.
browser_console_messagesCRead-only
Returns all console messages
Inputs: level (required), all, filename.
browser_dragADestructive
Perform drag and drop between two elements
Inputs: endTarget (required), startTarget (required), endElement, startElement.
browser_dropADestructive
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_mediaADestructive
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_evaluateCDestructive
Evaluate JavaScript expression on page or element
Inputs: function (required), target, element, filename.
browser_file_uploadBDestructive
Upload one or multiple files
Inputs: paths.
browser_fill_formBDestructive
Fill multiple form fields
Inputs: fields (required).
browser_findARead-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_dialogCDestructive
Handle a dialog
Inputs: accept (required), promptText.
browser_hoverADestructive
Hover over element on page
Inputs: target (required), element.
browser_network_requestARead-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_requestsARead-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_keyBDestructive
Press a key on the keyboard
Inputs: key (required).
browser_resizeBDestructive
Resize the browser window
Inputs: width (required), height (required).
browser_run_code_unsafeADestructive
Run a Playwright code snippet. Unsafe: executes arbitrary JavaScript in the Playwright server process and is RCE-equivalent.
Inputs: code, filename.
browser_select_optionBDestructive
Select an option in a dropdown
Inputs: target (required), values (required), element.
browser_snapshotARead-only
Capture accessibility snapshot of the current page, this is better than screenshot
Inputs: boxes, depth, target, filename.
browser_tabsADestructive
List, create, close, or select a browser tab.
Inputs: action (required), url, index.
browser_take_screenshotARead-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_typeBDestructive
Type text into editable element
Inputs: text (required), target (required), slowly, submit, +1 more.
browser_wait_forBRead-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
Scored across 25 tools
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.
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.
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.
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
Related MCP Connectors
Browz hosted MCP (free public beta): let an AI app drive your own Browz browser profiles from anywhere. Connect https://mcp.gobrowz.com/mcp and sign in with your Browz account (OAuth) or an agent token. Each call is relayed to the Browz app on your computer, which must be online with Remote control on and have a hardware security chip (Mac Secure Enclave or TPM 2.0). 17 tools: profiles, tabs, navigate, snapshot, act, wait, screenshot. Cookies, downloads and stored sign-ins stay on your computer.
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Let your AI agent operate any website through a real, logged-in browser session.
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Related MCP Servers
- AlicenseCqualityCmaintenanceEnables 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.5216 npmMIT
- AlicenseBqualityBmaintenanceEnables 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.1823 npm1GPL 2.0
- AlicenseNot gradedqualityBmaintenanceMCP 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.9Mozilla Public 2.0
- AlicenseNot gradedqualityCmaintenanceEnables 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