Filesystem MCP

---
name: Filesystem MCP
description: Give an agent scoped read/write access to a local directory via the reference filesystem MCP server.
platforms: [claude-code, cursor, windsurf, codex]
tags: [mcp, filesystem, local]
version: 1.0.0
author: Model Context Protocol
license: MIT
homepage: https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem
---

# Filesystem MCP

The reference [filesystem MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem)
exposes read, write, and directory-listing tools scoped to the paths you allow.

## Install

Drop [`mcp.json`](./mcp.json) into your client's MCP config, editing the allowed
root paths to match your machine. The server is fetched on demand via `npx`, so
there is nothing to install globally.

## Configuration

The final positional arguments are the directories the server is allowed to
touch. List one or more absolute paths. Anything outside them is denied.

> Grant the narrowest set of paths that the task needs.

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