Skip to content

MCP server

Filesystem MCP server

The MCP project's Filesystem reference server lets AI read, write, edit, move and search files, only inside folders you allow.

At a glance

Maintained by
Model Context Protocol project (Anthropic reference servers)
Tools exposed
10 listed below
Reviewed
September 24, 2026

Why it matters

What it does and why it matters

The Filesystem server lets an assistant work with files on your computer or server: read them, write new ones, edit existing ones, create folders, move files and search. Access is limited to the folders you list when you start it, which is its most important safety feature.

It is one of the most practical servers for everyday work, from organizing downloads to editing a set of documents or giving a coding assistant access to a project folder.

This is a reference server from the Model Context Protocol project. Reference servers show how the protocol works and are useful for learning and prototypes. Check the project notes before relying on one in production. Because it can write, edit and move files, list only the folders a task needs and keep backups of anything important. Never point it at your whole home folder or at folders with credentials.

Use cases

Best business use cases

Organize files

Sort and rename files in a folder.

Edit documents

Update text files in bulk with review.

Find content

Search a folder for files that mention a topic.

Project access

Give a coding assistant access to one project.

Data prep

Read CSV files and write cleaned versions.

Tools

Available tools

Tool names as published by the maintainer at review time. Versions change, so check the repository for the current list.

Read and write: Read and write: reads, creates, edits and moves files inside allowed directories only.

  • read_text_file

    Read a file as text.

  • read_multiple_files

    Read several files at once.

  • write_file

    Create or overwrite a file.

  • edit_file

    Make targeted edits to a file.

  • create_directory

    Create a directory.

  • list_directory

    List files and folders in a directory.

  • move_file

    Move or rename a file or directory.

  • search_files

    Search for files by pattern.

  • directory_tree

    Get a recursive tree view of a directory.

  • get_file_info

    Get file size, dates and permissions.

Workflows

Example workflows

Tidy a shared folder

  1. 1

    Allow one folder only.

  2. 2

    Ask the assistant to list and group files.

  3. 3

    It proposes a folder structure.

  4. 4

    You approve it.

  5. 5

    It creates folders and moves files.

Update a set of documents

  1. 1

    Allow the documents folder.

  2. 2

    Ask for a change, such as a new company address.

  3. 3

    The assistant searches for the old address.

  4. 4

    It shows the edits it plans.

  5. 5

    It applies them after approval.

Prompts

Example prompts

  • “List the files in this folder and suggest how to organize them.”

  • “Find every document that mentions our old address.”

  • “Read these CSV files and write a combined file without duplicates.”

Setup

Installation and configuration

Examples for Claude Desktop and Claude Code. Replace the placeholder values with your own keys, and store secrets outside version control.

Claude Desktop: claude_desktop_config.json

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

Claude Code: terminal

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir
  • Local server: stdio; @modelcontextprotocol/server-filesystem; mcp/filesystem.

Security

Security considerations

  • Allowed folders only

    List only the folders a task needs.

  • Backups

    Keep backups before bulk edits or moves.

  • No credential folders

    Never allow folders that hold keys or passwords.

  • Review edits

    Ask to see planned edits before they are applied.

Related servers

Servers that pair well with it

Git

The MCP project's Git reference server lets AI read history and diffs and stage, commit and switch branches in a local repository.

Google Drive

Google's own Drive MCP server lets AI search, read and create files in Google Drive, with your Google Workspace sign-in.

Dropbox

Dropbox's own MCP server lets AI list, search and read files, convert them to markdown and create, move, share and delete files. In beta.

Keep exploring

FAQ

Questions people ask us

Have a question that is not here? Ask us directly.

Start a project

Want this connected to your own systems? We build AI workflows with MCP.

Send a short brief. We reply with questions, a suggested plan and an estimate you can compare with other offers.

Your privacy choices

We use necessary storage to run this site. With your permission we also use Google Analytics to see which pages help people, and load maps from Google. You can change this at any time. Read the cookie policy.