Log inSubmit server
Camoufox MCP logo

Camoufox MCP

Automates Camoufox Firefox sessions with isolated contexts, page interaction, JavaScript evaluation, and network or console capture.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Camoufox MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "camoufox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "camoufox-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

camoufox-mcp MCP server exposes Camoufox, an anti-detection Firefox browser, to AI agents through MCP tools. It runs with npx and manages isolated browser sessions, pages, authentication state, navigation, interaction, inspection, and monitoring. Sessions can load or save cookies and localStorage using JSON files, while settings support headless mode, viewport, timeouts, humanization, and proxies. Reach for it when browser automation requires multiple authenticated contexts, Firefox-based anti-detection features, or detailed page and network inspection.

Use cases

  • Run multiple authenticated browser profiles in parallel
  • Automate forms and navigation in Camoufox Firefox
  • Reuse cookies and localStorage across browser sessions
  • Inspect network requests and browser console messages
  • Capture page text, screenshots, and framework state

Key features

  • Isolated browser sessions with saved authentication state
  • Firefox automation through Camoufox
  • Page interaction and JavaScript evaluation
  • Network interception and request capture
  • Console logging and interaction recording
  • Cookie popup dismissal

Tools35

What Camoufox MCP lets your agent do. Expand a tool for its parameters.

Self-reported~410 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

5/5 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · camoufox-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars7Stargazers on the source repository.
npm downloads189Package downloads in the last 30 days.
Last commit8mo agoMost recent push to the default branch.
Tools exposed35Callable tools this server registers over MCP.

How Camoufox MCP works

What camoufox-mcp does

camoufox-mcp MCP server gives an AI agent control of Camoufox through the Model Context Protocol. Camoufox is an anti-detection Firefox browser with fingerprint randomization, WebRTC leak protection, canvas fingerprint spoofing, and humanized cursor and click behavior. These browser characteristics are provided by the underlying Camoufox runtime rather than by separate MCP tools.

The server supports multiple isolated sessions inside one browser instance. Each session has separate cookies, localStorage, and cache, which allows authenticated profiles to run at the same time. Pages belong to sessions, can be selected for later actions, and can be opened or closed independently.

How it works

The server is started as a standard Node.js command with npx camoufox-mcp. An agent creates a session, opens a page, and uses snapshots or screenshots to identify content and interactive elements. Actions such as clicking by UID, filling fields, pressing keys, hovering, dragging, navigating, and extracting page text are then available through MCP.

JavaScript can run in either the page's main world or an isolated context. Main-world evaluation is synchronous, while isolated evaluation supports asynchronous code. The server can also extract Next.js and Nuxt.js framework state.

For authenticated workflows, a session can be created from a JSON storage-state file or receive one later through context injection. Saving a session exports its cookies and localStorage for reuse. Context files follow Playwright's storageState structure, with cookies and origin-specific localStorage entries.

Monitoring tools capture network requests and console messages, expose their logs, and allow captured data to be cleared. Network interception can block or modify requests. Interaction recording, popup dismissal, and page screenshots provide additional browser-control and diagnostic options.

Setup and configuration

Install and run the server with:

Terminal
npx camoufox-mcp

Claude Desktop can launch it through an MCP entry whose command is npx and whose argument is camoufox-mcp. The repository documents configuration through ~/.config/camoufox-mcp/settings.json.

Settings can define browser headless mode, viewport dimensions, operation timeout, and humanization level. They can also register context-file paths so an agent can discover them with list_context_files. Registered files are loaded lazily when a session is created.

Proxy settings support HTTP, HTTPS, and SOCKS5 server URLs. Username and password values may be supplied directly or through PROXY_SERVER, PROXY_USER, and PROXY_PASS environment substitutions. With geoip enabled, the browser timezone and locale are adjusted from the proxy IP location.

Tools and capabilities

The camoufox-mcp MCP server groups its tools around several workflows:

  • Create, list, save, inject, and close isolated sessions.
  • Open, list, select, and close pages.
  • Navigate, interact with controls, submit form values, and use keyboard input.
  • Capture text snapshots with element UIDs, screenshots, page text, and framework state.
  • Run synchronous main-world or asynchronous isolated JavaScript.
  • Capture, inspect, clear, block, or modify network traffic.
  • Capture, inspect, and clear browser console messages.
  • Record user interactions and dismiss cookie-consent popups.

This tool set fits tasks that need browser state to persist across calls, multiple logged-in profiles, or visibility into page behavior during automation.

Limitations and notes

The documented runtime requires Node.js 18 or newer. Main-world JavaScript evaluation is synchronous only; asynchronous evaluation is available in the isolated context. The server uses Firefox through Camoufox rather than Chromium, so browser-engine behavior may differ from Chrome-based automation.

Proxy credentials and session files can contain sensitive access information. Store them in appropriate locations and avoid exposing them through agent-visible logs.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Camoufox MCP

camoufox-mcp is an MCP server that connects AI agents to Camoufox, an anti-detection Firefox browser. Its main tools create isolated sessions, open and control pages, navigate sites, fill forms, capture snapshots and screenshots, evaluate JavaScript, manage storage state, and inspect network or console logs.

Install and start it with `npx camoufox-mcp`. For Claude Desktop, add an MCP server entry that uses `npx` as the command and `camoufox-mcp` as its argument. The documented runtime requires Node.js 18 or newer.

Reuse login state by creating a session with a JSON context file or injecting one into an existing session. The file uses Playwright storageState format with cookies and origin-specific localStorage. You can also save a session to export its current cookies and localStorage.

Yes, camoufox-mcp can run multiple isolated sessions at once. Each session has its own cookies, localStorage, and cache, so separate pages can operate with different authenticated profiles inside one Camoufox browser instance.

Configure a proxy in `~/.config/camoufox-mcp/settings.json` by enabling the proxy and providing an HTTP, HTTPS, or SOCKS5 server URL. Credentials can be set directly or referenced through `PROXY_SERVER`, `PROXY_USER`, and `PROXY_PASS`; `geoip` can adjust timezone and locale from the proxy location.

Related MCP servers

All in Browser Automation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCamoufox MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/camoufox-mcp?style=directory)](https://allmcps.com/mcp/camoufox-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/camoufox-mcp"><img src="https://allmcps.com/api/badge/camoufox-mcp?style=directory" alt="Camoufox MCP on AllMCPs" /></a>