Wsl Filesystem MCP Server

MCP server for wsl filesystem access

Local serverstdioTypeScript

What is the Wsl Filesystem MCP Server?

MCP server for wsl filesystem access

What the server does

Node.js server implementing the Model Context Protocol (MCP), specifically designed for filesystem operations in Windows Subsystem for Linux (WSL). This project is a fork of the original Filesystem MCP Server but completely reimagined for WSL environments. Unlike the original project, which handles generic file operations, this version focuses exclusively on seamless interaction between Windows and Linux distributions under WSL. Both projects are compatible and can run in parallel on the same system.

  • Access any WSL distribution from Windows
  • Read/write files in WSL from Windows host
  • Create/list/delete directories in WSL
  • Move files/directories across WSL filesystem
  • Search files within WSL
  • Get file metadata from the WSL filesystem

Credentials and setup notes

  • Windows Subsystem for Linux (WSL) properly configured - At least one Linux distribution installed in WSL For Claude Desktop users: No additional installation required — just configure your claude_desktop_config.json. NPM Package: The package is available on npm

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
read_fileRead complete contents of a file from WSL
read_file_by_partsRead large files in parts of approximately 95,000 characters
read_multiple_filesRead multiple files simultaneously from WSL
write_fileCreate or overwrite a file in WSL (use with caution)
edit_fileSelective edits with advanced pattern matching and formatting
create_directoryCreate or ensure the existence of a directory in WSL
list_directoryList directory contents with [FILE] or [DIR] prefixes
directory_treeRecursive JSON tree view of contents
move_fileMove or rename files/directories
search_filesRecursively search by name

How to install the Wsl Filesystem MCP Server

claude mcp add server-wsl-filesystem -- npx -y npm

Configuration

  • Windows Subsystem for Linux (WSL) properly configured - At least one Linux distribution installed in WSL For Claude Desktop users: No additional installation required — just configure your claude_desktop_config.json. NPM Package: The package is available on npm

Example prompts to try

  • “Use Wsl Filesystem to read file.”
  • “Use Wsl Filesystem to Input.”
  • “Use Wsl Filesystem to read file by parts.”

Frequently asked questions

MCP server for wsl filesystem access Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.