LocalFilesOrganizer-MCP

Overview

LocalFilesOrganizer-MCP is a comprehensive MCP server for managing local file systems. It provides a robust set of tools for reading and writing files (with UTF-8 and base64 support), directory operations, content searching with regex patterns, duplicate detection via MD5 hash comparison, and file analysis capabilities. The server emphasizes safety with configurable allowed paths, protected paths, and regex patterns to prevent accidental deletion of important files. It's cross-platform compatible and includes built-in protections for system directories and sensitive files like .git, .env, and .ssh directories.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• read_file

  Read file contents (UTF-8 or base64)

  Try:Read the contents of my project README fileTry:Show me what's in ~/config/settings.json
• write_file

  Write content to file (UTF-8 or base64)

  Try:Create a new file with my notesTry:Update the config with these changes
• delete_file

  Safely delete a file with protection checks

  Try:Remove the temporary log fileTry:Clean up old backup files
• move_file

  Move file with optional empty directory cleanup

  Try:Move this image to the pictures folderTry:Relocate the document to the archive directory
• analyze_file

  Get file stats (size, MIME, lines, words)

  Try:Tell me how big this PDF isTry:Show me the line count of my code file
• list_directory

  List files with optional recursion and glob patterns

  Try:Show me all files in my project folderTry:List all TypeScript files in this directory
• delete_directory

  Safely delete directory (requires confirmation for recursive)

  Try:Remove the temporary folderTry:Clean up build artifacts
• organize_by_type

  Organize files into folders by extension/date/size

  Try:Sort my downloads by file typeTry:Group photos by year they were taken
• search_content

  Search for regex patterns in file contents

  Try:Find all TODO comments in my codeTry:Search for the word 'important' in all markdown files
• find_duplicates

  Find duplicate files by MD5 hash

  Try:Identify duplicate photos in my pictures folderTry:Find duplicate files in my project directory
• sort_file_content

  Sort lines in a file

  Try:Sort the list of names in this fileTry:Order these entries by date
• rename_files

  Batch rename files using regex patterns

  Try:Rename all my photo files to have consistent namingTry:Update file extensions from .txt to .md

Comparable tools

Installation

{
  "mcpServers": {
    "local-files": {
      "command": "npx",
      "args": ["-y", "fsorg"]
    }
  }
}

git clone https://github.com/argtobias/fsorg.git
cd fsorg
pnpm install
pnpm build

FAQ

What safety protections does this server provide?

The server allows you to configure allowed paths for deletion, define additional protected paths, and specify regex patterns for protected file names. System paths and critical user directories are always protected.

Can I use this server for batch operations on files?

Yes, the server includes tools for batch renaming files using regex patterns and organizing files into folders by extension, date, or size.

Compare LocalFilesOrganizer-MCP with