# Folder

> Folder is a free MCP server for files and documents. Let ChatGPT or Claude find, read, save and edit files in folders you choose. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, macOS, iOS, API
- **Website:** https://folder.dev/docs/chatgpt-and-claude
- **MCP Registry name:** dev.folder/folder
- **Categories:** files and documents
- **Listing updated:** 2026-11-14

## About

Access is limited to the folders you tick on the connect screen, which can live on Folder itself or in your own Cloudflare R2 storage. You also choose Read Only or Read and Change. The docs say it never deletes or moves files, and every edit it makes is saved as a new version that restore_version can bring back.

Tools are labelled by risk. Reads cover listing folders and files, name search, reading text files up to 256 KB and listing versions. Writes create files, save uploads up to 10 MB and edit text by replacing a passage that must appear exactly once; edit_file refuses if the file changed since it was read, and create and save refuse to overwrite. Sensitive writes such as share links and revoking them need a second call with a confirm code, and share links only work on folders in your own Cloudflare.

Sign-in uses OAuth 2.1 with S256 PKCE through Sign in with Apple, and connected apps can be removed in Settings. Name search matches file names only, not file contents, and photos or PDFs are returned as a link rather than as content.

## Features

- **Folder-level permissions:** Pick which folders the app may use and whether it can only read or also change files.
- **Versioned edits:** Every change is a new version, and restore_version puts an earlier one back.
- **Safe text editing:** edit_file needs the old text to appear exactly once and refuses if the file changed since reading.
- **Confirm-code sharing:** Share links and revocations ask for a second call with a confirm code.
- **Your own Cloudflare:** Folders can sit in your own R2 buckets so the files never pass through Folder.
- **No deletes or moves:** The connection cannot delete or move files.

## Good for

- Ask Claude to find a document by part of its name
- Have ChatGPT save text from a chat as a new file
- Make a small edit to a text file and undo it later
- Review the version history of a file
- Create a share link for a file in your own Cloudflare storage

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http folder https://mcp.folder.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.folder.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "folder": {
      "url": "https://mcp.folder.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "folder": {
      "type": "http",
      "url": "https://mcp.folder.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "folder": {
      "serverUrl": "https://mcp.folder.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "folder": {
      "type": "http",
      "url": "https://mcp.folder.dev/mcp"
    }
  }
}
```

## Tools

- `list_folders`: Lists the folders this connection can use and whether files may be changed.
- `list_files`: Lists the files and folders in one folder, with a cursor for more.
- `search_files`: Finds files and folders whose name contains the given words.
- `read_file`: Reads a text file up to 256 KB and returns its version.
- `list_versions`: Lists every saved version of a file, newest first.
- `create_file`: Saves text from the chat as a new file; refuses to replace an existing one.
- `save_file`: Saves a dropped file or an https file up to 10 MB; refuses to replace an existing one.
- `edit_file`: Replaces one exact passage of text in a file.
- `restore_version`: Brings back an earlier version of a file.
- `create_share_link`: Creates a link others can open, after a confirm step; own-Cloudflare folders only.
- `revoke_share`: Stops a file's links from opening, after a confirm step.

## FAQ

### Can the assistant delete my files?

No. The docs say it never deletes or moves files, and every change becomes a new version you can restore.

### What does it cost?

5 GB on Folder is free during the beta, and a folder in your own Cloudflare is billed by Cloudflare at R2's price, listed at $0.015 per GB a month after 10 GB free.

### How do I connect it?

Use https://mcp.folder.dev/mcp as a connector, or run claude mcp add --transport http folder https://mcp.folder.dev/mcp in Claude Code.

### Can it search inside files?

No. search_files matches names only.

### Are share links available on Folder-hosted folders?

Not yet; the docs say they work on folders in your own Cloudflare, and a folder on Folder opens only for you.

### Is Folder free?

Yes. Folder is free to use.

### How do I add Folder to Claude Code?

Run this command in your terminal: claude mcp add --transport http folder https://mcp.folder.dev/mcp

### What are the best alternatives to Folder?

The closest alternatives to Folder are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/folder
