Filesystem
MCP server giving AI clients read, create, and edit access to local files
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"filesystem-mcp": {
"command": "npx",
"args": [
"-y",
"filesystem-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"filesystem-mcp": {
"command": "npx",
"args": [
"-y",
"filesystem-mcp"
]
}
}
}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.