How to set up the Filesystem MCP server
Checked against the official docs: Nov 4, 2026
The Filesystem MCP server ( @modelcontextprotocol/server-filesystem ) is the official reference server that lets an AI client read, write, edit, move and search files, but only inside the folders you allow. This guide covers the setup for each client, how the allowed folders work, read-only and Docker setups, what each tool does and the errors people run into. It is based on the server's README and changelog and the npm package, which was at version 2.1.0 (28 October 2026) when checked on 4 November 2026.
Quick answer
Needs: Node.js 24 or newer (since v2.0.0).
Command: npx -y @modelcontextprotocol/server-filesystem <absolute-path-to-folder> . Every folder the AI may use goes at the end, as its own argument.
Claude Code: claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem <absolute-path-to-folder>
Windows: launch it through cmd /c npx ...β¦