Cursor MCP File Organizer

A Model Context Protocol (MCP) server for organizing files in your Downloads folder using Cursor IDE.

Features

Automatically organizes files in Downloads folder by type
Supports multiple file categories:
- Images (jpg, jpeg, png, gif, webp, svg, etc.)
- Documents (pdf, doc, docx, txt, etc.)
- Archives (zip, rar, 7z, tar, etc.)
- Code files (js, ts, py, java, etc.)
- Media files (mp4, mp3, wav, etc.)
- Design files (psd, ai, sketch, etc.)
- Databases (sql, sqlite, etc.)
- Fonts (ttf, otf, woff, etc.)
Configurable organization rules
Real-time file system monitoring
SSE (Server-Sent Events) support for live updates

Prerequisites

Node.js (v14 or higher)
TypeScript
Cursor IDE

Installation

Clone the repository:

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

Configuration

Configure Cursor IDE MCP settings:

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

Customize organization rules in mcp-config.json:

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

Usage

Start the server:

npm start

Use Cursor IDE to send commands:

// Example command to organize files
{
  command: "organizeFiles",
  args: {
    path: "~/Downloads"
  }
}

Available Commands

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

Development

# Run in development mode with hot reload
npm run dev

# Build the project
npm run build

# Start the server
npm start

Project Structure

cursor-mcp-file-organizer/
├── src/
│   ├── server.ts      # Main server implementation
│   └── organizer.ts   # File organization logic
├── dist/             # Compiled JavaScript
├── package.json      # Dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── mcp-config.json   # Organization rules

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Cursor IDE team for the MCP protocol
Node.js community for the excellent tools and libraries

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Automatically organizes files in your Downloads folder by categorizing them into appropriate directories based on file types.

Related MCP Servers

mcp-neurolora
aindreyway
A
security
A
license
A
quality
Provides tools for collecting and documenting code from directories.
Last updated -
4
81
12
TypeScript
MIT License
Google Drive MCP Server
felores
-
security
A
license
-
quality
Enables integration with Google Drive for listing, reading, and searching over files, supporting various file types with automatic export for Google Workspace files.
Last updated -
1,971
9
JavaScript
MIT License
MCP File System Server
kvas-it
-
security
F
license
-
quality
This server provides an interface for performing basic file system operations such as navigation, reading, writing, and file analysis, allowing users to manage directories and files efficiently.
Last updated -
3
Python
Google Drive MCP Server
w-jeon
-
security
-
license
-
quality
Integrates with Google Drive to enable listing, reading, and searching over files, with automatic export of Google Workspace documents to appropriate formats.
Last updated -
1,971
JavaScript

View all related MCP servers

Cursor MCP File Organizer

Cursor MCP File Organizer

Features

Prerequisites

Installation

Configuration

Usage

Available Commands

Development

Project Structure

Contributing

License

Acknowledgments

Related MCP Servers

mcp-neurolora

Google Drive MCP Server

MCP File System Server

Google Drive MCP Server

Appeared in Searches

New MCP Servers

MCP directory API