Skip to main content

Filesystem MCP Server Setup: Connect Folders & Files to Claude (2026)

Use the official Filesystem MCP server so Claude can read and write files in folders you allow. Covers NPX/Docker install, directory access control, and safety.

ByUpdated

The Filesystem MCP server is an official reference server that lets Claude read and write files only within folders you allow on your computer. It is simple to set up and is the most common first MCP server for beginners. Here is the install, connection, and safe configuration.

🟢 Model references match the current lineup · model notice · Fable subscription
🟢 Model references match the current lineup · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (higher tier: Claude Fable 5.1). This notice changes only when Anthropic ships a new model.

Fable 5 and 5.1 subscription (updated September 7, 2026): Claude Fable 5.1, released September 1, 2026, is the current Fable model and Fable 5 is now legacy. Plan terms are the same for both — Max and Team Premium plans include Fable at up to 50% of the weekly usage limit; Pro and Team Standard use usage credits (

🟢 Model references match the current lineup · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (higher tier: Claude Fable 5.1). This notice changes only when Anthropic ships a new model.
0/M input, $50/M output tokens). The one-time
🟢 Model references match the current lineup · Claude Opus 5.5 / Claude Sonnet 5 / Claude Haiku 4.5 (higher tier: Claude Fable 5.1). This notice changes only when Anthropic ships a new model.
00 credit applied only to the Fable 5 transition and is not offered for 5.1. Some coding and debugging requests may be answered by an Opus model due to a security classifier (both models). See the Fable 5.1 guide and the Fable 5 availability guide for details.

Filesystem server — 4 stepsFilesystem server — 4 steps1. Config fileclaude_desktop_config2. Registernpx server-filesystem3. Allowed dirsset paths4. File tasksread · write

What it does

It provides tools for reading, writing, searching, and moving files within the directories you allow. The key point is that it only touches folders you allow — keeping the scope narrow is the basis of safe use.

Install — Claude Desktop (NPX)

You need Node.js installed. Register it in the config file claude_desktop_config.json as below. Replace the paths with the absolute paths of folders you actually want to allow. To allow more folders, keep adding paths to args.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

After saving, restart Claude Desktop and the filesystem server appears in the tools list.

Run with Docker

You can also run it with Docker instead of NPX (the official docs have mount examples). To make a folder read-only, add ro to the mount option.

In Claude Code

Register it with claude mcp add — see Claude Code MCP setup for details.

Access control (important)

There are two ways to set allowed folders — (1) specify them as command-line arguments as above, or (2) use MCP Roots (the method the official docs recommend). Either way, do not include sensitive folders such as passwords or financial records.

Connecting the Filesystem server① Register itWith Node.js ready,add it to claude_desktop_config.json② Allow foldersSet absolute paths viaCLI args orMCP Roots③ Approve & workRead, write, searchand move files withinallowed foldersIt only touches allowed folders — keep the scope narrow

Try it

Ask things like "read memo.txt on my Desktop" or "save a summary as summary.md in my reports folder," and Claude will ask to approve, then work within that folder.

Staying safe · troubleshooting

Since this is file access, keep the scope minimal (MCP connector security). If the server does not appear or errors out, see the troubleshooting guide.

Looking for more connectors? Browse the connector directory to search and filter common connectors by use case.

For other servers see recommended MCP servers and where to find them; for the full map see the connector & MCP catalog, and to build your own see Build your own MCP server. The official source is the Filesystem server repository.

Written July 2026; re-checked against the official repository on September 9, 2026 (npm latest 2026.8.31 — config format, recommended Roots, Docker read-only mount unchanged). Package names and options follow the official repository and may change between versions, so check the official docs as you configure. This is an unofficial guide.

Was this helpful?

Keep reading