Comparisons

The filesystem MCP server, and a safer way to let Claude organise

By the Muse team· 25 September 2026· 6 min read

The official filesystem MCP server lets Claude read, create, edit, move and rename files in folders you choose. It has no delete tool, but it can overwrite a file with no way back and scatter a folder with a bad rename. Scope it to one folder, keep a backup, and work in small batches.

The filesystem MCP server is the first thing most people connect to Claude, and for good reason. It is free, it is maintained by the Model Context Protocol project itself, and it lets Claude read, write, rename and move files in folders you choose. It is also the tool behind a lot of nervous posts asking what happens when Claude reorganises the wrong folder. For pictures, screenshots and saved links, Muse, a $29 Mac library with its own MCP server, is the safer fit, because anything an AI app removes goes to a Trash only you can empty.

This post sets out exactly what it can and cannot change, how to set it up so a mistake costs you little, and when a library app is the better fit for the job.

What can the filesystem MCP server do?

According to the server's own documentation, it offers thirteen tools. They fall into three groups:

A thirteenth tool lists the folders the server is allowed to touch. Those folders are whatever you name when you set it up, and it cannot see anything outside them.

Notice what is missing. There is no delete tool. Claude cannot remove a file through this server. That is reassuring, but it is not the whole story.

Can Claude lose or damage my files through it?

Yes, in two ways, even without a delete tool.

The first is overwriting. The write tool creates a new file or replaces an existing one completely, and the documentation itself adds "exercise caution with this". The edit tool changes a file in place. Neither keeps the previous version. If Claude writes over a document you cared about, the old one is gone unless Time Machine or another backup has it.

The second is scattering. Moving and renaming are the heart of "organise this folder" requests, and a plan that looked sensible can leave three hundred files renamed by a pattern you did not want, spread across folders Claude invented. Nothing is lost, strictly, but putting it back by hand can take longer than the tidy-up saved.

There is also a quieter risk. Claude reads what is in your files, and text inside a file can influence what it does next. A folder of downloaded documents is not always a folder of trustworthy instructions.

Claude asks before it acts, so read the request.

Claude Desktop asks for your approval before a tool runs. For moves and writes, read what it is about to do rather than approving a batch on reflex. The approval is the safety feature.

How to set it up safely

None of this is a reason to avoid it. It is a reason to set it up with a small blast radius:

  1. Give it one working folder, not your home folder. Make a folder such as Claude Workspace and list only that. Copy files in when you want Claude to work on them.
  2. Keep a backup running. Time Machine, or any versioned backup, turns an overwrite from a loss into an inconvenience.
  3. Start with reading. Ask for a summary or a plan first ("suggest how you would rename these"), check it, then ask it to carry the plan out.
  4. Work in batches. Twenty files at a time are easy to check. Two thousand are not.

A setup scoped to a single folder looks like this in Claude Desktop's config file:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop/Claude Workspace"
      ]
    }
  }
}

Our Claude Desktop setup guide covers where that file lives and what to do when a server does not appear.

Filesystem server or a library app: which fits?

The filesystem server is general purpose. It sees files as names, folders and text. That makes it right for code, documents, notes and anything you want edited where it lives. It is less suited to a pile of pictures, screenshots and saved links, because to find "the orange poster" it has to open files one by one and look.

A library app that includes its own MCP server works the other way round. The app has already done the indexing, so an AI app asks it questions instead of walking your disk. Muse is one example. Things you save are copied into Muse's library folder, which stays plain folders you can open in Finder, and Claude works through Muse's own actions rather than your file system.

 Muse MCP serverFilesystem MCP server
PricePart of MuseFree
Works on any file, where it isNo, on what you save to MuseYes, in folders you allow
Edits text filesNoYes
Search by colour, text in pictures, or lookYesNo, file names only
Removed items can be restoredYes, from Muse's TrashNo delete tool, but overwrites are final
Copy saved before the first AI change each dayYes, last seven keptNo
Can browse the rest of your MacNoOnly folders you list

In Muse, anything an AI app removes goes to the Trash, which only you can empty. Before the first change an AI app or script makes each day, Muse saves a copy of your library and keeps the last seven, with Undo AI Changes in Settings > Library > Backup. Items you have hidden never appear to an AI app at all. The Connect AI Apps guide lists every action.

Plenty of people will want both: the filesystem server for a projects folder, and a library app for the visual things they collect. They sit side by side in the same config file without any trouble.

Frequently asked

Can Claude delete files with the filesystem MCP server?
No. The official filesystem server has no delete tool. It can still overwrite a file completely or change it in place, and neither keeps the previous version, so keep a backup running.
Can Claude access my whole Mac?
Only the folders you list in its setup, or the folders your MCP app passes to it. Everything outside those is invisible to it. Listing your whole home folder is possible, but a single working folder is much safer.
Does the filesystem MCP server need Node.js?
Yes, in its usual setup it runs through npx, which comes with Node.js. Check with node --version in Terminal, and install the LTS version from nodejs.org if it is missing.
Can Claude see images through the filesystem server?
It can read an image file and look at it, one file at a time. What it cannot do is search a folder by what the pictures show, their colours or the text inside them, so finding one picture among thousands is slow.
Can I use the filesystem server and Muse together?
Yes. Each is one entry in the same mcpServers section of your config file, and Claude picks whichever fits the request.

A library Claude can tidy safely

Free for 30 days. Then $29 once, and it is yours.

Written by the Muse team

We build Muse, a native Mac app that keeps everything you collect in one private library and finds it again in seconds.