Filesys 📁

Source

This is a Filesystem MCP server that could allow an LLM to read and list files from a specified directory on your local machine.

Catalog onlyCatalog onlySTDIO

Overview

Filesys is a Filesystem MCP server that enables an AI agent to read and list files from a specified directory on your local machine, facilitating seamless file management through the Model Context Protocol (MCP).

To use Filesys, download the necessary files from the GitHub repository, launch the server, and start managing your files with the AI agent's assistance.

Allows AI agents to interact with the local filesystem. - Supports file reading and listing operations. - Built on the Model Context Protocol for efficient file management.

Enabling AI agents to access and manage local files.
Streamlining file operations for developers using AI.
Integrating file management capabilities into AI-driven applications.

Add to your AI client

Use these steps to connect Filesys 📁 in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "filesys-yothisistroy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-yothisistroy"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "filesys-yothisistroy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-yothisistroy"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "filesys-yothisistroy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-yothisistroy"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "filesys-yothisistroy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-yothisistroy"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "filesys-yothisistroy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-yothisistroy"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "filesys-yothisistroy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-yothisistroy"
      ]
    }
  }
}

FAQ

Can Filesys work with any local directory?

Yes! Filesys can read and list files from any specified directory on your local machine.

Is there any setup required before using Filesys?

Yes! You need to download and launch the server to start using it.

What programming language is Filesys built with?

Filesys is built using Python.

Developer tools

Filesys 📁 MCP Server — MCP Registry