Skip to content
MCP server

Filesystem

MCP server giving AI clients read, create, and edit access to local files

Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally or Remotely
Version
1.3.0
Listing updated
today

Similar MCP servers

About Filesystem

Filesystem is an open-source MCP server for files and documents. It can run locally on your machine or as a hosted remote server.

The README says filesystem-mcp is an MCP server that lets an AI client read, create and edit files on a machine. Its toolset is small: a view tool reads file contents or lists a directory with line numbers, create writes or overwrites a file, str_replace swaps an exact string inside a file, and insert adds text at a given line.

The server runs over stdio for desktop clients, or as a streamable HTTP endpoint on localhost port 3000 when started with the MCP_TRANSPORT setting. It is published to npm and set up through a generated config for common MCP clients.

It suits developers and power users who want an assistant to make precise edits to code or config files, back up a file before changing it, or write generated notes into a folder.

Install

Run in a terminal

claude mcp add filesystem-mcp -- npx -y filesystem-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "filesystem-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "filesystem-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "filesystem-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "filesystem-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "filesystem-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "filesystem-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "filesystem-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "filesystem-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "filesystem-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "filesystem-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MCP_TRANSPORTTransport type.Required

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

view
Read file contents or list directory (with line numbers)
create
Create or overwrite a file
str_replace
Replace an exact string in a file
insert
Insert text at a specific line

What it does

Directory and file viewing
Reads file contents or lists a directory, with line numbers in the output.
Exact string replacement
Changes a file by replacing a specific string, so edits stay targeted.
Line-based insertion
Inserts text at a chosen line number inside an existing file.
File creation and overwrite
Creates new files or overwrites existing ones through the create tool.
Stdio and HTTP transports
Runs over stdio for local clients or as a streamable HTTP server.

Good for

  • Make a precise rename or refactor in a source file
  • Switch a value such as an API endpoint in a config file
  • Back up a file with a timestamped copy before editing it
  • Save generated reports or notes into a local folder

Pricing

Open source

Free and open source; no paid plan mentioned.

Filesystem FAQ

Which transports does it support?

The registry entry lists stdio and streamable-http. The HTTP mode runs on localhost port 3000 and requires the MCP_TRANSPORT variable set to http.

How is it installed?

The README points to install-mcp, which generates the right configuration for MCP clients such as Claude Code, Claude Desktop, Cursor, Cline and VS Code. The package is published to npm as filesystem-mcp.

How do I contribute?

The README asks contributors to install Git and Node.js, clone the repository, run npm install, then npm run test and npm run build.

Is Filesystem free?

Yes. Filesystem is open source, so you can use and self-host it for free.

How do I add Filesystem to Claude Code?

Run this command in your terminal: claude mcp add filesystem-mcp -- npx -y filesystem-mcp

What are the best alternatives to Filesystem?

The closest alternatives to Filesystem are MCP Server Filesystem, Filesystem MCP, FileSystem MCP Server, MCP Server Commands and Makefile MCP.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers