File Organizer

The Cursor MCP File Organizer is an MCP server that watches your Downloads folder and automatically sorts files by type, helping you keep your workspace tidy. It supports many categories such as images, documents, archives, code, media, design files, databases, and fonts, with configurable rules to tailor the organization to your needs.

How to use

To use this MCP server, first ensure the server is running and accessible from your MCP client. You will then send commands from your client to organize your Downloads folder and manage files. The key command is to organize files by type, which re-sorts existing files into their designated folders based on the configured rules. You can also browse directory contents, read and write files, move files, and create directories through the available MCP commands.

How to install

Prerequisites you need before installing are Node.js (v14 or higher), TypeScript, and Cursor IDE.

Step by step install and run flow you can follow:

# Clone the project
git clone https://github.com/AlexanderVTr/cursor-mcp-file-organizer.git
cd cursor-mcp-file-organizer

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Configuration and usage notes

Configure the MCP client to connect to the file organizer server and tailor the organization rules for your Downloads folder.

{
  "mcpServers": {
    "file_organizer": {
      "url": "http://localhost:3001",
      "port": 3001,
      "enabled": true,
      "description": "File organization MCP server"
    }
  }
}

Organization rules example

You can customize how files are sorted in a dedicated configuration, mapping file extensions to destination folders under your Downloads path.

{
  "version": "1.0",
  "rules": {
    "downloads": {
      "path": "~/Downloads",
      "organizeBy": {
        "images": {
          "extensions": [".jpg", ".jpeg", ".png", ".gif", ".webp", ".svg"],
          "destination": "~/Downloads/Pictures"
        }
        // Additional categories can be added here
      }
    }
  }
}

Available commands

• listDir: List directory contents
• readFile: Read file contents
• writeFile: Write content to a file
• moveFile: Move a file to a new location
• createDir: Create a directory
• organizeFiles: Organize files by type

Notes on server features

The server includes real-time updates via SSE so you can monitor changes as they happen in your Downloads folder.

Available tools

organizeFiles

Organizes files recursively within a specified path by their type according to configured rules.

listDir

Lists contents of a directory for inspection or selection.

readFile

Reads the contents of a file and returns it to the MCP client.

writeFile

Writes content to a specified file path from the MCP client.

moveFile

Moves a file from one location to another.

createDir

Creates a new directory at a given path.