# Cursor MCP: add 1folder so Cursor saves and reads your files

> Add 1folder to Cursor and it can save briefs and notes to files that Claude Code, Codex or ChatGPT can read next. Put its address under mcpServers in .cursor/mcp.json, or ~/.cursor/mcp.json for all your projects. Finish the sign-in from Customize, choose its folders in 1folder and press Allow, then ask Cursor to save a small brief.

*Picture: Cursor (reads a feature brief and saves implementation notes) connected to one 1folder holding Search implementation (a page saved by Cursor, version 2) and Search acceptance criteria (a page saved by you).* Cursor reads the feature criteria and updates Search implementation in 1folder. Its saved notes have a private link and versions independent of the local code.

## Connect Cursor to 1folder

1. **Add the remote server configuration.** In your project, merge this entry into .cursor/mcp.json, preserving any servers already there: { "mcpServers": { "1folder": { "url": "https://1folderapp.com/mcp" } } } For access across projects, use ~/.cursor/mcp.json instead.

   *Picture: Adding 1folder to Cursor with this configuration: { "mcpServers": { "1folder": { "url": "https://1folderapp.com/mcp" } } }*
2. **Complete the sign-in in Cursor.** Open Customize and find the 1folder server. Follow its authentication prompt to sign in to 1folder. Cursor supports browser sign-in for remote HTTP servers.
3. **Choose the folders and press Allow.** Pick the Product space or just the folders for this work. Choose View and edit to save files, or View only to review them, then press Allow.

   *Picture: 1folder’s Allow page: “Cursor wants to use your 1folder”, with Only the folders I pick in Product and View and edit chosen, then Allow.*
4. **Check one saved file.** Ask Cursor to save Search implementation and return its private link. Open the file and check the actual contents before handing over more work.

   *Picture: In Cursor, you type: “Save Search implementation in my 1folder Product folder and give me its private link.” Cursor saves Search implementation (a page saved by Cursor, version 1) to 1folder.*

## Requests to try with the connected app

- In Cursor: “Read Search acceptance criteria in my 1folder Product folder. Compare them with the current search UI and list gaps before editing.”
- In Cursor: “Save Search implementation in 1folder: files changed, code revision, keyboard behaviour, empty state, checks actually run and unresolved questions. Return its private link.”
- In Cursor: “Read the current Search implementation page and update the same file with the accessibility findings below. Keep unresolved issues clearly marked.”

## Cursor MCP servers: local commands and remote addresses

Cursor can connect to local programs and to remote servers. A local setup has a command for Cursor to launch; a remote setup has a url. 1folder is remote, so use https://1folderapp.com/mcp in the JSON configuration rather than copying an unrelated local-server command.

Cursor manages MCP servers from Customize in its sidebar, and reads them from mcp.json. The setup above uses mcp.json, so the address and the file are plain to see. No separate 1folder program is needed.

## Choose where to put the Cursor MCP setup

| | File | Use it for |
|---|---|---|
| Project configuration | .cursor/mcp.json | Tools associated with this project |
| Your global configuration | ~/.cursor/mcp.json | Your tools across projects |

## Add a remote MCP server to Cursor without replacing other entries

Merge the 1folder object into the existing mcpServers object. Keep the other entries if you use other tools, and keep valid JSON with commas between entries. The exact 1folder entry is shown in the setup picture above.

The url points at the remote service; it is not a local file path or an instruction to launch a process. Complete sign-in when Cursor prompts for it. You do not need to invent credentials or copy authentication settings from another service.

## Verify a feature brief rather than a generic test

Use a Search acceptance criteria page with three requirements: filter by file name, show an empty state when nothing matches, and keep keyboard focus in the search field. Ask Cursor to read the page and save Search implementation describing what the code currently does.

Open the saved result and check that it names the repository revision, relevant paths and actual verification. When you ask Cursor to update it after a code change, its saved page gets a new version. Compare the notes, and separately inspect the source changes in Git.

## If the remote connection is present but not useful

- Check the configuration path and JSON first. An entry in one project’s .cursor/mcp.json doesn’t load in other projects.
- Finish the server’s sign-in and Allow page. A registered address is not the same as access to your 1folder files.
- Check the [permitted folder and editing level](https://1folderapp.com/how-to/give-claude-access-to-folder.md). View only can support review but cannot save implementation notes.
- Ask Cursor explicitly to read the current file before updating it. 1folder does not automatically copy local files or synchronise repositories.
- Use View only for a [second app reviewing the brief](https://1folderapp.com/integrations/claude-code-and-codex-together.md). Give it editing access only if it should change the saved work.

## Questions

### What JSON adds a Cursor remote MCP connection?

Use { "mcpServers": { "1folder": { "url": "https://1folderapp.com/mcp" } } }. Merge that entry into your existing configuration rather than discarding other servers.

### Should I use .cursor/mcp.json or ~/.cursor/mcp.json?

Cursor documents the first as project configuration and the second as your global configuration. Choose according to where you want the tool available.

### Do I need a command to start the 1folder server?

No. 1folder runs at its remote address. Cursor’s command-based examples are for local servers, a different setup.

### Can Cursor and Claude Code work from the same brief?

Yes. Connect [Claude Code](https://1folderapp.com/integrations/claude-code-mcp.md) and Cursor to the same 1folder folder and ask each to read the latest saved brief. Coordinate source changes with Git and your normal development workflow.

### Can I undo Cursor’s work?

In 1folder you can compare and undo its saved file changes. That does not undo edits in your local repository; use Git for those.

## Sources

- [Cursor docs: Model Context Protocol](https://cursor.com/docs/mcp)

Checked on November 11, 2026.

## Read next

- [Use Claude Code and Codex together on the same files, with Cursor too](https://1folderapp.com/integrations/claude-code-and-codex-together.md): Use Claude Code, Codex and Cursor together with a saved handoff, code revision and checks. Connect each app once and keep the next agent’s starting point clear.
- [Claude Code MCP: add 1folder so your plans and handoffs are kept](https://1folderapp.com/integrations/claude-code-mcp.md): Add 1folder to Claude Code with one command. It saves plans, handoffs and reports you can open anywhere, and Codex, Cursor or ChatGPT can pick them up.
- [An AI agent workspace: shared files for every agent you use](https://1folderapp.com/use-cases/ai-agent-workspace.md): 1folder gives Claude Code, Codex, Cursor and your chat apps one shared workspace of files. Each agent gets its own access; every change is a version.
- [Add 1folder to ChatGPT as a connector, so it saves and opens your files](https://1folderapp.com/integrations/chatgpt-connectors.md): Add 1folder as a ChatGPT connector so ChatGPT saves its work to your files and opens them in any chat. Business, Enterprise and Edu can save; Pro only reads.

[Add 1folder to your AI app, free](https://1folderapp.com/signin) · [All resources](https://1folderapp.com/resources.md)

Website: https://1folderapp.com/ · Contact: hello@1folderapp.com