Set up Filesystem

Reads, writes, searches and moves local files, limited to the directories you pass in when it starts.

Publisher

MCP Steering Group Official

Run locally

npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir

Transports

stdio

Authentication

None. Access is limited to directories passed as arguments or through roots.

What it can touch

Reads and writes files inside the allowed directories.

Licence

MIT (existing) / Apache-2.0 (new contributions)

Source

github.com/modelcontextprotocol/servers/tree/main/src/filesystem

Status

Active

Install

This server runs on your machine as a child process of the client. You need the runtime its command uses, such as Node.js for npx, uv for uvx or Docker, plus any variables listed under Environment.

Claude Code

claude mcp add --scope project filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir

Cursor

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/dir"
      ]
    }
  }
}

Codex

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]

Config for other clients →