MCP server for wsl filesystem access
If you already use Wsl Filesystem, the wsl filesystem mcp server is the piece that lets your assistant work with it directly. MCP server for wsl filesystem access.
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.
The server ships on npm as npm, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
read_file — Read complete contents of a file from WSLInput — path (string)read_file_by_parts — Read large files in parts of approximately 95,000 charactersInputs — - path (string)Features — - Part 1 starts from the beginning of the fileread_multiple_files — Read multiple files simultaneously from WSLwrite_file — Create or overwrite a file in WSL (use with caution)edit_file — Selective edits with advanced pattern matching and formattingNon — destructive dry run modecreate_directory — Create or ensure the existence of a directory in WSLlist_directory — List directory contents with [FILE] or [DIR] prefixesdirectory_tree — Recursive JSON tree view of contentsclaude_desktop_config.json. NPM Package: The package is available on npmThis sits in the file and storage access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Wsl Filesystem's toolset — read_file, Input, read_file_by_parts and 11 more — is a fair guide to whether it matches your workflow. It is maintained by webconsulting; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Wsl Filesystem's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| read_file | Read complete contents of a file from WSL |
| Input | path (string) |
| read_file_by_parts | Read large files in parts of approximately 95,000 characters |
| Inputs | - path (string) |
| Features | - Part 1 starts from the beginning of the file |
| 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 |
| 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 |
> {
> "mcpServers": {
> "filesystem": {
> "command": "npx",
> "args": [
> "-y",
> "@modelcontextprotocol/server-filesystem",
> "\\\\wsl.localhost\\Debian",
> "C:\\path\\to\\other\\allowed\\dir"
> ]
> }
> }
> }
>Configuration as documented by the project. Restart the client after saving.
claude_desktop_config.json. NPM Package: The package is available on npmScoped local file access — read, write, search and reorganise files in directories you explicitly allow.
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.
Connects AI models to an Obsidian knowledge base for direct access and manipulation of notes and folders.