# Filesystem

> Filesystem is an open-source MCP server for files and documents. MCP server giving AI clients read, create, and edit access to local files. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API, macOS, Linux, Windows
- **Repository:** https://github.com/domdomegg/filesystem-mcp
- **MCP Registry name:** io.github.domdomegg/filesystem-mcp
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add filesystem-mcp -- npx -y filesystem-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [MCP Server Filesystem](https://ai-powered.com/mcp/mcp-server-filesystem): MCP Server Filesystem is an open-source MCP server for files and documents.
- [Filesystem MCP](https://ai-powered.com/mcp/filesystem-mcp): Filesystem MCP is a free MCP server for files and documents.
- [FileSystem MCP Server](https://ai-powered.com/mcp/filesystem-mcp-server): FileSystem MCP Server is an open-source MCP server for files and documents.
- [MCP Server Commands](https://ai-powered.com/mcp/mcp-server-commands): MCP Server Commands is an open-source MCP server for developer tools.
- [Makefile MCP](https://ai-powered.com/mcp/makefile-mcp-2): Makefile MCP is an open-source MCP server for developer tools.
- [Edit MCP](https://ai-powered.com/mcp/edit-mcp): Edit MCP is an open-source MCP server for developer tools.
- [Coding Tools MCP](https://ai-powered.com/mcp/coding-tools-mcp): Coding Tools MCP is an open-source MCP server for developer tools.
- [Movi MCP v1](https://ai-powered.com/mcp/movi-mcp-v1): Movi MCP v1 is an open-source MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/filesystem
