Desktop Organizer MCP Server

MCP server for organizing files on your Mac Desktop by automatically categorizing them into folders.

Features

• List Desktop Files: View all files on your Desktop grouped by category
• Organize Desktop: Move files into category folders (Images, Documents, Videos, etc.)
• Preview Mode: Dry-run option to preview changes before organizing
• File Categorization: Get the category for any file based on its extension

Supported Categories

• Images: .jpg, .jpeg, .png, .gif, .bmp, .svg, .heic, .webp
• Documents: .pdf, .doc, .docx, .txt, .rtf, .pages, .odt
• Spreadsheets: .xls, .xlsx, .csv, .numbers, .ods
• Presentations: .ppt, .pptx, .key, .odp
• Videos: .mp4, .mov, .avi, .mkv, .wmv, .flv, .webm
• Audio: .mp3, .wav, .aac, .flac, .m4a, .ogg
• Archives: .zip, .rar, .7z, .tar, .gz, .bz2, .dmg
• Code: .py, .js, .java, .cpp, .c, .h, .swift, .go, .rs
• Scripts: .sh, .bat, .ps1, .zsh, .fish
• Data: .json, .xml, .yaml, .yml, .toml, .sql
• Others: Any files that don't match the above categories

Setup

1. Install dependencies:

   python3 -m venv venv
   source venv/bin/activate
   pip install mcp
   

2. Configure Claude Desktop:

   Edit your Claude Desktop config file at:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   Add this configuration:

   {
     "mcpServers": {
       "desktop-organizer": {
         "command": "/Users/robertwatson/Code/desktop-organizer-mcp/venv/bin/python",
         "args": ["/Users/robertwatson/Code/desktop-organizer-mcp/src/server.py"]
       }
     }
   }
   

3. Restart Claude Desktop to load the MCP server

Available Tools

list_desktop_files

Lists all files on your Desktop grouped by category.

Example: "Show me what files are on my Desktop"

organize_desktop

Organizes Desktop files by moving them into category folders.

Parameters:

• dry_run (boolean, optional): Preview changes without moving files (default: false)

Examples:

• "Organize my Desktop files" - Actually moves files
• "Show me how my Desktop would be organized" - Dry run preview

get_file_category

Get the category for a specific file.

Parameters:

• filename (string, required): The filename to categorize

Example: "What category is report.pdf?"

Usage Examples

Once configured in Claude Desktop, you can ask:

• "What files are on my Desktop?"
• "Organize my Desktop files"
• "Show me a preview of how my Desktop would be organized"
• "What category would screenshot.png be in?"

Development

Run the server directly for testing:

source venv/bin/activate
python src/server.py