File System Server MCP Server

Enables AI assistants to securely interact with a local file system for reading, writing, and managing files within a designated project directory.

Local serverstdioPython★ 45

What is the File System Server MCP Server?

Enables AI assistants to securely interact with a local file system for reading, writing, and managing files within a designated project directory.

What you get

A simple Model Context Protocol (MCP) server providing file system operations. This server offers a clean API for performing file system operations within a specified project directory, following the MCP protocol design.

This MCP server enables AI assistants like Claude (via Claude Desktop) or other MCP-compatible systems to interact with your local file system. With these capabilities, AI assistants can:

  • list_directory: List all files and directories in the project directory
  • read_file: Read a file, or a line slice via start_line/end_line
  • save_file: Write a file, creating parent directories as needed
  • append_file: Append content to the end of a file
  • delete_this_file: Delete a single specified file from the filesystem
  • delete_directory: Delete a directory (empty by default, whole tree with recursive=True)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_directoryLists files and directories in the project directory
read_fileReads the contents of a file
save_fileCreates or overwrites files atomically
append_fileAdds content to existing files
delete_this_fileRemoves files from the filesystem
delete_directoryDeletes a directory (empty, or a whole tree with recursive)
edit_fileMakes selective edits using exact string matching
move_fileMoves or renames files/directories (git-aware: uses git mv for tracked files, else filesystem move)
get_reference_projectsLists available reference projects
list_reference_directoryLists files in a reference project
read_reference_fileReads files from reference projects

How to install the File System Server MCP Server

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-workspace",
      "args": [
        "--project-dir",
        "C:\\path\\to\\your\\specific\\project",
        "--reference-project",
        "docs=C:\\path\\to\\documentation",
        "--reference-project",
        "examples=C:\\path\\to\\examples",
        "--log-level",
        "INFO"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • “Use File System Server to Operation.”
  • “Use File System Server to list directory.”
  • “Use File System Server to read file.”

Frequently asked questions

By configuring the Claude Desktop App to use this server, you enable Claude to interact with your files, allowing it to assist with coding, debugging, and project management.