desktop-organizer
Organizes files on macOS Desktop by automatically categorizing them into folders such as Images, Documents, Videos, etc.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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
Related MCP server: vulcan-file-ops
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
Install dependencies:
python3 -m venv venv source venv/bin/activate pip install mcpConfigure 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"] } } }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.pyTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
Your IMAP mailbox as an MCP server: read, search and (if you allow it) organize mail. Open source.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP Server for an Agent Task Marketplace
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server to list and launch applications on MacOS19MIT
- AlicenseAqualityBmaintenanceMCP server that gives Claude Desktop and other desktop MCP clients filesystem powers—read, write, edit, and manage files like AI coding assistants.1777 npm9MIT
- AlicenseBqualityDmaintenanceAn MCP server designed for managing files and folders specifically on the Windows Desktop. It enables users to perform file operations like deletion while implementing security measures to prevent path traversal outside the Desktop directory.1MIT
- AlicenseBqualityBmaintenanceA powerful, security-hardened MCP server for intelligent file organization. Provides high-level atomic tools for organizing files into categories, detecting duplicates, extracting EXIF/ID3 metadata, scheduling automatic organization, and more — for use with Claude, Cursor, and Gemini CLI.26161 npm46MIT