Skip to the content
GuidesSign inAdd to your AI

Codex MCP: add 1folder so Codex saves and reads your files

Short answer

Add 1folder to Codex and it can save handoffs and reports to files that Claude Code, Cursor or ChatGPT can read next. Run codex mcp add 1folder --url https://1folderapp.com/mcp, then codex mcp login 1folder. Sign in, choose the folders Codex may use and press Allow. Check it with codex mcp list, then ask Codex to save one handoff file.

Checked on November 11, 2026 against 2 sources.

Add to your AIFree to start. No card.
Codex saves Checkout handoff with the code revision, checks and next action. The shared folder keeps that page beside the release criteria you supplied.

Connect Codex to 1folder

  1. Add 1folder from your terminal

    Run codex mcp add 1folder --url https://1folderapp.com/mcp. This registers the remote address; it does not yet prove that the app can open your files.

  2. Sign in to 1folder

    Run codex mcp login 1folder and complete the sign-in in the browser. Use codex mcp list to check the entry, and /mcp inside Codex to inspect active servers.

  3. Choose the folders and press Allow

    Pick the Engineering space or just the folders for this work. Choose View and edit to save files, or View only to review them, then press Allow.

  4. Check one saved file

    Ask Codex to save Checkout handoff and return its private link. Open the file and check the actual contents before handing over more work.

Requests to try with the connected app

  • In Codex

    “Read Release criteria in my 1folder Engineering folder. Compare them with this checkout and list what is still unverified before editing.”

  • In Codex

    “Save Checkout handoff in 1folder with the repository, branch, commit, uncommitted changes, decisions, checks actually run and next action. Return the private link.”

  • In Codex

    “Read the current Checkout handoff, check its revision against this checkout, then update that same page with your verified test results.”

Codex MCP servers connect tools; they do not share a session

An MCP connection lets Codex use a service’s tools while it works. Codex supports local programs as well as remote HTTP servers. For 1folder, the remote address is enough: there is no helper package to run on your computer.

Keep source code and normal repository history in Git. Use 1folder for a project brief, decisions and a current handoff that another app or person can open. The connection does not copy your Codex transcript or make another app resume the same session.

Codex CLI MCP commands to use

WhatRun in your terminalWhat it checks or changes
Addcodex mcp add 1folder --url https://1folderapp.com/mcpRegisters the remote server address
Sign incodex mcp login 1folderStarts sign-in for the registered server
Listcodex mcp listShows your configured servers
Inspect in a session/mcp inside CodexShows active MCP servers in the terminal interface

Where the configuration lives

OpenAI documents ~/.codex/config.toml as the default configuration file. A trusted project can use .codex/config.toml for project-scoped settings. MCP entries live under mcp_servers, with a url for a remote HTTP server. The desktop app, CLI and IDE extension share the configuration for the same Codex host.

If an entry appears in one place and not another, check which machine and configuration file that Codex uses. Setting it up on your laptop doesn’t set it up on another computer.

Codex MCP login: common checks before trying again

If the server is listed but cannot open your files, finish codex mcp login 1folder and the 1folder Allow page. Registration alone is not a completed sign-in. For a terminal without a local browser, OpenAI documents codex mcp login 1folder --no-browser: open the printed authorization address in a browser and paste the full redirect address back as instructed.

If Codex can read but cannot save, check View and edit for the 1folder connection. If it cannot find a particular file, check that the file is in the space or folders you allowed. Repeating the add command cannot widen that access.

Make the first saved result useful

  • Include a commit and working-tree state in Checkout handoff. “Tests passed” is only meaningful when it says which tests ran against which code.
  • Ask Codex to mark incomplete work and checks it did not run. The next app should verify the checkout before trusting the handoff.
  • Request updates to the existing file. Each save creates a version attributed to the app, so you can compare or undo changes to the saved page.
  • Use its private link with connected apps. Only the person can make the file public. A 1folder undo changes the saved file, not your repository.

Questions

What is the Codex MCP add command for 1folder?
Run codex mcp add 1folder --url https://1folderapp.com/mcp. Follow it with codex mcp login 1folder to complete sign-in.
Does the CLI setup also apply to the IDE extension?
OpenAI says the CLI, IDE extension and desktop app share MCP configuration for the same Codex host. A different host may have a different configuration.
Why does codex mcp login need a browser?
The sign-in lets you choose the 1folder account, folders and editing access. For terminals without a local browser, OpenAI documents the --no-browser login option and a copy-and-paste completion flow.
Can Claude Code read what Codex saved?
Yes. Give Claude Code its own connection to the same folder and ask it to read the current handoff. This shares the saved file, not Codex’s chat history.
Does 1folder sync my repository or commits?
No. It keeps pages and files you save. Use Git to move code between checkouts and confirm that the saved handoff matches the actual revision.

Sources

Checked on November 11, 2026.

Read next

All resources

Give Codex one place to keep its work.

Set it up once. Everything it saves is kept with every version, easy to find and ready to share.

Add to your AI

Free to start. No card needed.