vibedonaldsvibedonalds.com
Filesystem MCP Server screenshot

Filesystem MCP Server

Reference MCP server in Node.js that lets AI clients read, write, edit and search files in folders you allow.

What is Filesystem MCP Server, in two sentences

Filesystem MCP Server is a Node.js reference server in the modelcontextprotocol/servers GitHub repository that lets MCP clients such as Claude Desktop and VS Code read, write, edit, move and search files in directories you allow. Its README says it is licensed under the MIT License and free to use, modify and distribute.

About Filesystem MCP Server

Published on npm as @modelcontextprotocol/server-filesystem, the server gives an MCP client tools that read whole text files or their first or last N lines, media files as base64 with their MIME type and several files at once; write, edit and move files; create and list directories, with sizes or as a JSON tree; search recursively with glob patterns; and return metadata such as size, timestamps and permissions.

The server may touch only its allowed directories, passed as command-line arguments, as in mcp-server-filesystem /path/to/dir1 /path/to/dir2; the README calls this the only method that works on every protocol version. A 2025-era client that supports Roots can replace the list at runtime, but Roots is deprecated as of protocol version 2026-07-28. The list_allowed_directories tool shows the current list, and every tool sets openWorldHint: false, which the README ties to local-only access.

For Claude Desktop, the README's claude_desktop_config.json entry runs npx -y @modelcontextprotocol/server-filesystem followed by the allowed paths, launched through cmd /c on Windows. A Docker entry runs the mcp/filesystem image with each directory mounted under /projects, and adding ro to a mount makes it read-only. In VS Code, the server goes in your user mcp.json, opened with MCP: Open User Configuration, or in a workspace's .vscode/mcp.json to share it with others.

The modelcontextprotocol/servers README describes the repository as home to a small number of reference servers maintained by the MCP steering group, meant to demonstrate MCP features and SDK usage. The filesystem README says the server is licensed under the MIT License; the repository README says new contributions are licensed under the Apache License 2.0 and existing code under MIT.

Sources: github.com/modelcontextprotocol/servers/tree/main/src/filesystem and /modelcontextprotocol/servers, read 2026-10-27

Filesystem MCP Server pros and cons

Pros

  • Each tool carries MCP tool annotations, so clients can tell read-only tools from tools that write and see which writes are idempotent or destructive.
  • edit_file can show a git-style diff in dry-run mode, and the README advises previewing every edit that way before applying it.
  • It serves both protocol eras on stdio: clients on the 2026-07-28 protocol, which send server/discover, and 2025-era clients, which use initialize.

Cons

  • The repository README calls its servers educational examples for developers building their own MCP servers, not production-ready solutions, and tells developers to evaluate their own security requirements.
  • write_file and edit_file overwrite files in place, and the README warns that a crash mid-write can leave a file partly written.
  • Running it through npx or from source requires Node.js 24 or later.
  • Without command-line directories it has nothing to work on: a 2026-07-28 client gets an error on every tool call, and a 2025-era client without Roots support makes the server exit at initialization.

Tagged

  • Self-hostable
  • Supports Claude
  • CLI
  • MCP Support
  • Multi-file Edits
  • Open Source

Filesystem MCP Server alternatives

More from MCP Servers.

  1. 01
    Cloudflare MCP Server

    Cloudflare's product-specific remote MCP servers, such as Documentation, Container, Browser Run and CASB.

    Free →
  2. 02
    Stripe MCP Server

    Stripe's hosted MCP server at mcp.stripe.com, with tools for agents to read and write Stripe API data.

    →
  3. 03
    Notion MCP Server

    Notion's self-hosted MCP server for the Notion API, which its README says is no longer actively maintained.

    Free →
  4. 04
    Sentry MCP Server

    Sentry's MCP server for coding agents such as Cursor and Claude Code, built for debugging with Sentry data.

    →
  5. 05
    Sequential Thinking MCP Server

    Reference MCP server with one sequential_thinking tool for step-by-step reasoning that can revise and branch.

    Free →
  6. 06
    Memory MCP Server

    Reference MCP server that keeps an AI client's memory in a local knowledge graph of entities and relations.

    Free →

Related reading

Reviews
No reviews yet — be the first to rate Filesystem MCP Server.

Featured on Vibedonalds

Own Filesystem MCP Server? Add this badge to your site to show you’re listed — and link back to your profile here.

Filesystem MCP Server — Featured on Vibedonalds
<a href="https://vibedonalds.com/tools/mcp-filesystem" target="_blank" rel="noopener">
  <img src="https://vibedonalds.com/badge/featured-on-vibedonalds.svg" alt="Filesystem MCP Server — Featured on Vibedonalds" width="240" height="60" loading="lazy" />
</a>

Frequently asked questions

What is Filesystem MCP Server?
Filesystem MCP Server is a reference MCP server in Node.js that lets AI clients read, write, edit and search files in folders you allow.
Is Filesystem MCP Server free?
Filesystem MCP Server is free to use. There is no paid tier as of the last index update.
What are the alternatives to Filesystem MCP Server?
Similar tools in MCP Servers on vibedonalds: Cloudflare MCP Server, Stripe MCP Server, Notion MCP Server, Sentry MCP Server.
What are the downsides of Filesystem MCP Server?
The repository README calls its servers educational examples for developers building their own MCP servers, not production-ready solutions, and tells developers to evaluate their own security requirements. write_file and edit_file overwrite files in place, and the README warns that a crash mid-write can leave a file partly written. Running it through npx or from source requires Node.js 24 or later. Without command-line directories it has nothing to work on: a 2026-07-28 client gets an error on every tool call, and a 2025-era client without Roots support makes the server exit at initialization.
How do I install the Filesystem MCP Server with npx?
Add an entry to your MCP client's configuration that runs npx -y @modelcontextprotocol/server-filesystem followed by each directory the server may use, such as /Users/username/Desktop. On Windows, the README launches npx through cmd /c. Running through npx or from source needs Node.js 24 or later.
How do I use the Filesystem MCP Server with Claude Desktop?
Add the README's entry to claude_desktop_config.json. The npx version passes your allowed directories as arguments; the Docker version runs the mcp/filesystem image with each directory mounted under /projects, and adding ro to a mount makes that directory read-only for the server.
How do I add the Filesystem MCP Server to VS Code?
Open the Command Palette with Ctrl + Shift + P, run MCP: Open User Configuration and add the server to your user mcp.json, or put it in .vscode/mcp.json to share it with others in a workspace. The README's VS Code entries pass ${workspaceFolder} as the allowed directory.
Which files can the Filesystem MCP Server access?
Only files inside its allowed directories, passed on the command line; the list_allowed_directories tool shows them. The README says the server only accesses the local filesystem within those directories, never an open or external world. A 2025-era client that supports Roots can replace the list at runtime.
Is the Filesystem MCP Server free, and who maintains it?
Its README says it is licensed under the MIT License, which means you are free to use, modify and distribute it; the repository README adds that new contributions are under the Apache License 2.0. It is one of the reference servers in modelcontextprotocol/servers, which that README says the MCP steering group maintains and Anthropic manages with the community.