Skip to the content
GuidesSign inAdd to your AI

Claude Code MCP: add 1folder so your plans and handoffs are kept

Short answer

Add 1folder to Claude Code and it can save plans, handoffs and reports to files you open anywhere, and Codex or ChatGPT can pick them up. Run claude mcp add --transport http 1folder https://1folderapp.com/mcp, start Claude Code, open /mcp and sign in to 1folder. Choose the folders it may read or edit, then ask it to save a handoff and open the link.

Checked on November 11, 2026 against its source.

Add to your AIFree to start. No card.
Claude Code saves Release handoff beside your acceptance criteria. The next session can read the current handoff, with a version showing each saved update.

Connect Claude Code to 1folder

  1. Add 1folder from your terminal

    Run claude mcp add --transport http 1folder 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

    Start Claude Code and enter /mcp. Select 1folder and complete its sign-in in the browser.

  3. Choose the folders and press Allow

    Pick the Release 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 Claude Code to save Release 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 Claude Code

    “Save Release handoff in 1folder: goal, branch, commit, changed files, exact checks run with results, blockers and next step. Return its private link.”

  • In Claude Code

    “Read Release handoff in 1folder and compare its branch and commit with this checkout before editing. Report mismatches.”

  • In Claude Code

    “Update the same Release handoff page with the test result below. Mark the browser check as not run.”

What Claude Code MCP servers add

Claude Code can work with local code without this connection. An MCP server adds another service’s tools to the session. A remote server lives at a web address; a local server is started with a command on your computer. For 1folder, use the remote HTTP setup above, with no extra package to install.

The useful first result is a handoff someone can inspect. Keep code in your repository, and save the goal, exact revision and remaining work to a page in 1folder. This does not upload the repository or transfer the full session.

Choose the configuration scope

WhatScopeWhere it applies
LocalDefault when no scope is suppliedYour use in the current project
ProjectAdd --scope project to the commandStored in .mcp.json for the project; other people review and approve it
UserAdd --scope user to the commandYour use across projects

Claude Code MCP add: verify registration and sign-in separately

Run claude mcp list to see configured servers and their status. Run claude mcp get 1folder to inspect this one. An “Added” result means the configuration was written; you still need a working connection and sign-in. Open /mcp in an interactive session if authentication or approval is pending.

If the server is missing in another checkout, check the scope before adding duplicates. If tools appear but saving fails, check the folder you allowed and whether the connection has View and edit. A read-only connection is enough to read a handoff, but cannot update it.

Make the handoff worth reading

  • Record the branch and commit as well as uncommitted edits. The next agent must inspect its own checkout; a page cannot put the code at the right revision.
  • Write actual checks and their results. Say “not run” for anything you have not verified. A saved claim is not evidence that a test passed.
  • Ask for an update to the same file. Compare versions in 1folder to see what changed, and undo an incorrect saved edit. Git remains the place to undo repository changes.
  • Use a private link. Only the person can turn on a public read-only link; Claude Code cannot publish the handoff for you.

Questions

Do I need to run a local server for 1folder?
No. 1folder is a Claude Code remote MCP server at https://1folderapp.com/mcp. The HTTP command connects to that address rather than launching a program on your machine.
How do I add an MCP server to Claude Code for every project?
Add --scope user to the command. The default is local scope for the current project; project scope is for a shared .mcp.json configuration.
Why does Claude Code say it needs authentication?
Adding the server and signing in are separate steps. Open /mcp, choose 1folder and finish the browser sign-in and Allow page.
Does it save the session automatically?
No. Ask Claude Code to save a handoff. 1folder keeps that file and its versions, not the session history or hidden state.
Can I use Codex on that saved handoff?
Yes. Connect Codex to the same folder and ask it to read the latest file. This gives Codex the saved handoff, while code changes move through your usual Git workflow.

Sources

Checked on November 11, 2026.

Read next

All resources

Give Claude Code 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.