⚠️ IMPORTANT INFORMATION: The original Filesystem MCP Server can already access WSL files by simply using the network path \\wsl.localhost\DistributionName as a parameter in the configuration.…
mcp-server-wsl-filesystem is an MCP project maintained in the webconsulting/mcp-server-wsl-filesystem repository. The maintainer describes its purpose as “⚠️ IMPORTANT INFORMATION: The original Filesystem MCP Server can already access WSL files by simply using the network path \wsl.localhost\DistributionName as a parameter in the…”. Read the project documentation for the complete scope.
The documented npm package is mcp-server-wsl-filesystem. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| read_file | Read complete contents of a file from WSL |
| read_file_by_parts | Read large files in parts of approximately 95,000 characters |
| Inputs: | path (string) - root directory to search |
| part_number | positive integer: 1, 2, 3, etc.) |
| Features: | Handles all special characters (apostrophes, quotes, $, backslashes) |
| read_multiple_files | Read multiple files simultaneously from WSL |
| write_file | Create or overwrite a file in WSL (use with caution) |
| edit_file | Selective edits with advanced pattern matching and formatting |
| edits | array of { oldText, newText }) |
| dryRun | boolean, optional) |
| Git | style diff preview |
| Non | destructive dry run mode |
| create_directory | Create or ensure the existence of a directory in WSL |
| list_directory | List directory contents with [FILE] or [DIR] prefixes |
| directory_tree | Recursive JSON tree view of contents |
| move_file | Move or rename files/directories |
| search_files | Recursively search by name |
| excludePatterns | string[], optional) - file patterns to exclude |
| search_in_files | Search for text patterns within files recursively |
| caseInsensitive | boolean, optional) - case-insensitive search |
| isRegex | boolean, optional) - treat pattern as regex |
| includePatterns | string[], optional) - file patterns to include (e.g., .js) |
| maxResults | number, optional, default: 1000) - maximum results to return |
| contextLines | number, optional, default: 0) - lines of context before/after |
| get_file_info | Detailed metadata |
| Returns | size, timestamps, type, permissions |
| list_allowed_directories | Lists all directories accessible to the server |
| list_wsl_distributions | Lists available distributions and shows the active one |
{
"mcpServers": {
"wsl-filesystem": {
"command": "npx",
"args": [
"-y",
"mcp-server-wsl-filesystem",
"--distro=Ubuntu-20.04",
"/home/user/documents"
]
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Chat with your second brain — search, read and write vault notes through the Local REST API.
Manage Proxmox hypervisors through a Model Context Protocol server, providing a clean interface for nodes, VMs, and containers.