Filesystem MCP
Rank #2,703io.github.j0hanz/filesystem-mcp
Secure filesystem MCP server for reading, writing, searching, diffing, and patching files.
Filesystem MCP is a Model Context Protocol (MCP) server published by j0hanz. It ranks #2,703 of 115,460 servers tracked on MCP Toplist, and its repository has 13 GitHub stars. Filesystem MCP is listed across 2 registries — Official MCP and Glama, with 52 tracked versions. It was first listed on Jan 10, 2026 and most recently updated on Aug 27, 2026.
Ranks ahead of 112,757 of 115,460 servers on MCP Toplist.
Use Filesystem MCP
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add filesystem-mcp -e "FS_ALLOWED_DIRS=<your FS_ALLOWED_DIRS>" -- npx -y @j0hanz/filesystem-mcpReplace each placeholder with your own value before saving.
claude mcp add filesystem-mcp -e "FS_ALLOWED_DIRS=<your FS_ALLOWED_DIRS>" -- docker run -i --rm -v "{host_dir}:/workspace:ro" ghcr.io/j0hanz/filesystem-mcp:2.0.0 /workspaceReplace each placeholder with your own value before saving.
[mcp_servers.filesystem-mcp]
command = "npx"
args = ["-y", "@j0hanz/filesystem-mcp"]
[mcp_servers.filesystem-mcp.env]
FS_ALLOWED_DIRS = "<your FS_ALLOWED_DIRS>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
[mcp_servers.filesystem-mcp]
command = "docker"
args = ["run", "-i", "--rm", "-v", "{host_dir}:/workspace:ro", "ghcr.io/j0hanz/filesystem-mcp:2.0.0", "/workspace"]
[mcp_servers.filesystem-mcp.env]
FS_ALLOWED_DIRS = "<your FS_ALLOWED_DIRS>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"filesystem-mcp": {
"command": "npx",
"args": [
"-y",
"@j0hanz/filesystem-mcp"
],
"env": {
"FS_ALLOWED_DIRS": "<your FS_ALLOWED_DIRS>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"filesystem-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"{host_dir}:/workspace:ro",
"ghcr.io/j0hanz/filesystem-mcp:2.0.0",
"/workspace"
],
"env": {
"FS_ALLOWED_DIRS": "<your FS_ALLOWED_DIRS>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"filesystem-mcp": {
"command": "npx",
"args": [
"-y",
"@j0hanz/filesystem-mcp"
],
"env": {
"FS_ALLOWED_DIRS": "<your FS_ALLOWED_DIRS>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"filesystem-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"{host_dir}:/workspace:ro",
"ghcr.io/j0hanz/filesystem-mcp:2.0.0",
"/workspace"
],
"env": {
"FS_ALLOWED_DIRS": "<your FS_ALLOWED_DIRS>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"filesystem-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@j0hanz/filesystem-mcp"
],
"env": {
"FS_ALLOWED_DIRS": "<your FS_ALLOWED_DIRS>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"servers": {
"filesystem-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"{host_dir}:/workspace:ro",
"ghcr.io/j0hanz/filesystem-mcp:2.0.0",
"/workspace"
],
"env": {
"FS_ALLOWED_DIRS": "<your FS_ALLOWED_DIRS>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"filesystem-mcp": {
"command": "npx",
"args": [
"-y",
"@j0hanz/filesystem-mcp"
],
"env": {
"FS_ALLOWED_DIRS": "<your FS_ALLOWED_DIRS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"filesystem-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"{host_dir}:/workspace:ro",
"ghcr.io/j0hanz/filesystem-mcp:2.0.0",
"/workspace"
],
"env": {
"FS_ALLOWED_DIRS": "<your FS_ALLOWED_DIRS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"filesystem-mcp": {
"command": "npx",
"args": [
"-y",
"@j0hanz/filesystem-mcp"
],
"env": {
"FS_ALLOWED_DIRS": "<your FS_ALLOWED_DIRS>"
}
}
}
}Replace each placeholder with your own value before saving.
{
"mcpServers": {
"filesystem-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"{host_dir}:/workspace:ro",
"ghcr.io/j0hanz/filesystem-mcp:2.0.0",
"/workspace"
],
"env": {
"FS_ALLOWED_DIRS": "<your FS_ALLOWED_DIRS>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.j0hanz%2Ffilesystem-mcp)<a href="https://mcptoplist.com/server/io.github.j0hanz%2Ffilesystem-mcp"><img src="https://mcptoplist.com/badge/io.github.j0hanz%2Ffilesystem-mcp.svg" alt="MCP Toplist: Top 5% of 115,460" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 1 registry (1 delisted)
j0hanz
Other servers by j0hanz
- Filesystem Context#7,750 · 2 vers
- Fetch URL MCP Server#10,435 · 82 vers
- Code Lens#14,267 · 41 vers
- Cortex MCP#19,220 · 19 vers
- Memory MCP#35,019 · 4 vers
- PromptTuner MCP#81,997
- MCP Playwright Server#84,140
- Todokit MCP Server#84,141
- memdb#99,526
Available versions (52)
| Version | Published |
|---|---|
| 2.0.0 | Aug 27, 2026 |
| 1.19.1 | Apr 11, 2026 |
| 1.19.0 | Apr 11, 2026 |
| 1.18.0 | Apr 11, 2026 |
| 1.17.1 | Apr 10, 2026 |
| 1.17.0 | Apr 10, 2026 |
| 1.16.3 | Apr 10, 2026 |
| 1.16.2 | Apr 10, 2026 |
| 1.16.1 | Apr 10, 2026 |
| 1.16.0 | Apr 10, 2026 |
| 1.15.5 | Apr 10, 2026 |
| 1.15.1 | Apr 10, 2026 |
| 1.15.0 | Apr 10, 2026 |
| 1.14.1 | Apr 10, 2026 |
| 1.14.0 | Mar 11, 2026 |
| 1.13.2 | Mar 9, 2026 |
| 1.13.1 | Mar 9, 2026 |
| 1.13.0 | Mar 9, 2026 |
| 1.12.0 | Mar 6, 2026 |
| 1.11.1 | Mar 6, 2026 |
| 1.11.0 | Mar 6, 2026 |
| 1.9.1 | Mar 5, 2026 |
| 1.9.0 | Mar 5, 2026 |
| 1.8.0 | Mar 1, 2026 |
| 1.7.3 | Feb 28, 2026 |
| 1.7.2 | Feb 27, 2026 |
| 1.7.1 | Feb 25, 2026 |
| 1.7.0 | Feb 25, 2026 |
| 1.6.2 | Feb 25, 2026 |
| 1.6.1 | Feb 24, 2026 |
| 1.6.0 | Feb 24, 2026 |
| 1.5.4 | Feb 23, 2026 |
| 1.5.3 | Feb 23, 2026 |
| 1.5.2 | Feb 23, 2026 |
| 1.5.1 | Feb 22, 2026 |
| 1.5.0 | Feb 21, 2026 |
| 1.4.0 | Feb 21, 2026 |
| 1.3.2 | Feb 21, 2026 |
| 1.3.1 | Feb 21, 2026 |
| 1.3.0 | Feb 21, 2026 |
| 1.2.4 | Feb 20, 2026 |
| 1.2.3 | Feb 20, 2026 |
| 1.2.2 | Feb 19, 2026 |
| 1.2.1 | Feb 19, 2026 |
| 1.2.0 | Feb 19, 2026 |
| 1.1.2 | Feb 13, 2026 |
| 1.1.1 | Feb 11, 2026 |
| 1.1.0 | Feb 11, 2026 |
| 1.0.4 | Feb 11, 2026 |
| 1.0.1 | Feb 10, 2026 |
| 1.0.0 | Feb 10, 2026 |
| 0.1.0 | Nov 25, 2024 |
Frequently asked questions
- Who maintains Filesystem MCP?
- Filesystem MCP is maintained by j0hanz, which publishes 14 MCP servers (200 total versions) tracked on MCP Toplist.
- Is Filesystem MCP listed on the Official MCP Registry?
- Yes — Filesystem MCP is listed on the Official MCP Registry, alongside Glama.
- How many versions does Filesystem MCP have?
- MCP Toplist tracks 52 versions of Filesystem MCP, most recently published on Aug 27, 2026.
- Where can I find the source code for Filesystem MCP?
- The source code for Filesystem MCP is hosted at github.com/j0hanz/filesystem-mcp.