Skip to main content
Glama
Firefox Workspace for Codex

Firefox Workspace for Codex

Firefox Workspace for Codex

CI MIT license

Give Codex a dedicated group of background tabs in your existing Firefox profile. Codex can open pages, read them, follow links, and fill ordinary form fields while you work in other tabs.

This is an independent open-source project. It connects to local Codex through MCP.

Requirements

  • macOS and desktop Firefox 160 or newer

  • Node.js 24 or newer

  • A local Codex client with MCP support

Related MCP server: firefox-browser-control

Install from source

git clone https://github.com/crystaldaking/chatgpt-firefox.git
cd chatgpt-firefox
npm ci
npm run build
npm run install:local
codex mcp add chatgpt-firefox -- "$(command -v node)" "$PWD/dist/mcp-server.mjs"
  1. In Firefox, open about:debugging#/runtime/this-firefox, select Load Temporary Add-on, and select dist/extension/manifest.json from the checkout.

  2. Open Firefox Workspace for Codex from Firefox's extensions menu in the window you want to use and select Connect Codex.

  3. Restart your local Codex client or reopen its MCP settings so it loads the new server. In a local chat, ask it to call firefox_status. The response should show connected: true.

  4. Ask Codex to open a URL in its Firefox workspace. The first time it requests that site, open the Firefox extension, select Allow next to the origin and confirm the browser prompt. Then ask Codex to retry.

For example, ask “Open https://example.org in the Firefox workspace and tell me its heading.” The workspace appears in a group named Codex after its first tab opens.

Use Share or return tab in Codex workspace from a Firefox tab's context menu to give Codex access or take the tab back. Select Stop access in the extension to disconnect and leave the tabs open.

The temporary add-on needs to be loaded again after restarting Firefox. This version is distributed as source.

Permissions and data

The extension uses tab metadata to verify group membership and reports only workspace tabs to Codex. Site access requires an explicit approval for each origin in the current workspace. You can revoke it in the popup. Ordinary Firefox cookies are applied by the browser in its existing profile.

The bridge uses a per-user Unix socket and Firefox Native Messaging. Page text, titles, URLs, and interaction results returned by MCP may become part of your Codex conversation. The project runs no hosted service and sends no project telemetry. See data handling and security boundaries.

Page operations target the main document, and clicks use DOM events. Some sites require a manual click, sign-in, a system dialog, or other interactions outside this interface.

Remove

Unload the temporary add-on in about:debugging, then run the following from the checkout.

codex mcp remove chatgpt-firefox
npm run uninstall:local

Develop

npm ci
npm run check

On macOS with the native host installed, use npm run test:firefox to run the full MCP → Firefox browser test in an isolated profile. See contributing, architecture, and agent instructions.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    • Recall MCP server for ChatGPT, Claude and any AI agent: save URL, create note, add tags to card, remove tags from card, delete card, export card as Markdown, search cards and list card connections in your own Recall account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Recall yourself; Cotlet does not store your password and you need no Recall API key. About the official Recall API: Yes, but it only reads. Recall has a REST API and an MCP server, both included in the Free plan, and both are read-only (checked 25 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/recall-api-mcp-server

      https://cotlet.dev/mcp/v1/recall
    • Fathom MCP server for ChatGPT, Claude and any AI agent: list calls, complete action item, add action item, share call, set link access, regenerate summary, update settings and delete call in your own Fathom account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Fathom yourself; Cotlet does not store your password and you need no Fathom API key. About the official Fathom API: Fathom has a REST API and an official MCP server, but both only read your calls (checked 22 Oct 2026). The API lists meetings and returns summaries, transcripts and action items, requests recording downloads and manages webhooks. Setup and FAQ: https://cotlet.dev/integrations/fathom-video-api-mcp-server

    • Zotero MCP server for ChatGPT, Claude and any AI agent: add item by DOI, search library, add to collection, get annotations, create note and export citations in your own Zotero account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Zotero yourself; Cotlet does not store your password and you need no Zotero API key. About the official Zotero API: Zotero has a public Web API v3 with read and write access (checked 16 Oct 2026). You create a key in your zotero.org account settings and send it with each request. Setup and FAQ: https://cotlet.dev/integrations/zotero-api-mcp-server

      https://cotlet.dev/mcp/v1/zotero
    • Feedly MCP server for ChatGPT, Claude and any AI agent: list feeds, list articles, search articles, save article to Board, mark articles as read and follow source in your own Feedly account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Feedly yourself; Cotlet does not store your password and you need no Feedly API key. About the official Feedly API: Feedly has a REST API, but only Enterprise clients can create a token, and its documented endpoints are built around Threat Intelligence (checked 17 Oct 2026). Feedly's official MCP server, Feedly Threat Graph, queries threat intelligence and needs an Advanced or Enterprise account. Setup and FAQ: https://cotlet.dev/integrations/feedly-api-mcp-server

      https://cotlet.dev/mcp/v1/feedly

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables Codex to manage a local Firefox session by listing, grouping, opening, activating, navigating, and closing non-private tabs and native tab groups through a secure local native-messaging bridge.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Codex to operate your already-open Firefox tabs via local MCP tools for status, tab management, navigation, interaction, and screenshots on Windows x64 with Firefox 140+.
      1
      AGPL 3.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to create, read, and operate granted background tabs in Chrome via a local stdio MCP server, preserving the human's front tab. Supports tab groups, navigation, clicking/typing, screenshots, and human-priority permissions.
      MIT