Skip to main content
Glama
camoufox-agent

camoufox-agent

by VolanDeVovan

camoufox-agent

An MCP server that gives coding agents a browser: Camoufox (anti-detect Firefox) with tools shaped like Claude in Chrome's.

IMPORTANT

This project is vibe-coded: the code was written by Claude Code, with tests but without a line-by-line human review. It drives a browser that holds your real logged-in sessions. Treat it as an experiment, read the code before you trust it, and expect rough edges.

The reference it borrows from is mcp-camoufox.

Why

The goal was an MCP as convenient as Claude in Chrome, but one that does not get caught by CAPTCHAs and anti-bot checks the way an automated Chrome does.

Two things are central:

  • Profiles. A profile is an identity: one device fingerprint and one set of logins, kept on disk as a plain Firefox profile directory. The agent creates and manages profiles itself, and find_session(site) tells it which profile is already logged in somewhere.

  • Importing sessions from Firefox. examples/firefox-import/ copies a Firefox container (cookies, and optionally localStorage / IndexedDB) into a profile, so the agent can use sessions you already have.

Possible next step: converting cookies and sessions from Chrome and other browsers.

Related MCP server: Camoufox Browser MCP

What you get

  • Tabs, page snapshots with refs, clicks and typing, screenshots, console, network, JavaScript: the Claude in Chrome tool set, plus network bodies, browserless HTTP with the profile's cookies, and anti-bot diagnostics (31 tools, docs/tools.md).

  • A visible window per profile, so you can watch and take over.

  • One daemon per user holds the browsers, so parallel agent sessions share a profile.

  • Every click reports what the page did; secrets are masked in tool output.

  • Challenge pages are detected and handed to you. Nothing solves CAPTCHAs.

Install

Needs Node >= 22.15. It is not on npm yet; each release has a prebuilt tarball that npx runs directly:

claude mcp add camoufox -- npx -y https://github.com/VolanDeVovan/camoufox-agent/releases/latest/download/camoufox-agent.tgz

With Nix: nix run github:VolanDeVovan/camoufox-agent.

From a clone: pnpm install && pnpm build, then register node dist/mcp/server.js.

The first tool call that needs a browser downloads Camoufox (about 1.3 GB, once). The server tells the agent how to use it; there is no skill to install.

camoufox-agent [--default-profile NAME] [--profiles-dir DIR] [--headless]

Profiles live in ~/.local/share/camoufox-agent/profiles/<name>/.

Development

pnpm test

Tests run a real headless Camoufox against local pages. How it works is described in docs/.

License

MIT. Parts of the navigation, masking and markdown code are adapted from mcp-camoufox (MIT).

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Provides privacy-focused browser automation using a specialized Firefox fork with advanced anti-detection and fingerprint spoofing capabilities. It enables AI assistants to navigate websites, retrieve HTML content, and capture screenshots while maintaining anonymity.
      17
      345 npm
      54
      MIT
    • 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
    • A
      license
      Not graded
      quality
      A
      maintenance
      Gives MCP-compatible AI agents an anti-detection browser toolset for navigating, interacting with, searching, and extracting content from websites, plus downloads, multi-tab workflows, and persistent sessions with cookies and saved profiles. It enables reliable automation of the web without getting blocked by running against a separate Camoufox-based browser server.
      581 npm
      MIT