Filesystem MCP Server

MCP Server Configuration

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

Important: Replace /path/to/allowed/directory with the actual directory you want to grant access to. You can specify multiple directories:

Copy
"args": [
  "-y",
  "@modelcontextprotocol/server-filesystem",
  "/Users/dev/projects",
  "/Users/dev/documents"
]

Available Tools

Tool	Description
read_file	Read complete contents of a file
read_multiple_files	Read multiple files simultaneously
write_file	Create or overwrite a file
edit_file	Make line-based edits to existing files
create_directory	Create a new directory (with parents)
list_directory	List directory contents
directory_tree	Get recursive directory tree
move_file	Move or rename files and directories
search_files	Search for files matching a pattern
get_file_info	Get file metadata (size, modified, permissions)
list_allowed_directories	Show which directories are accessible

Setup

1. Add the configuration to .claude/settings.json
2. Update the directory path(s) to match your project
3. No API keys needed — runs locally
4. Requires Node.js and npx available in PATH

Security Notes

• Sandboxed access — Only directories listed in args are accessible
• Files outside the allowed directories cannot be read or written
• Symlinks that point outside allowed directories are blocked
• No network access — purely local file operations
• Always use the most restrictive directory scope possible
• Avoid granting access to home directory or root