Omniscient Master Suite OMNISCIENT · 3.1
Sign in with OmniumPortalSign in

Folder Cleaner v1.0.0

Files & backup day-folder-cleaner 3 actions MCP

Declutter a messy folder: move loose files into subfolders grouped by modified date or by file type, then sweep away any folders left empty. Every organise can be previewed as a dry-run first and undone afterward.

Open in Omniscient Back to apps

The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.

Actions

Jump to: organiseundoremove_empty

Organise folder

organise Destructive

Move every loose top-level file in a folder into a subfolder named for its modified date or its file type. Never overwrites, never touches files already inside a subfolder. Use --dry-run to preview.

Inputs

NameTypeRequired / defaultValues and notes
folder path required
by enum optional, default date datetype
granularity enum optional, default month daymonthyear

Outputs

NameTypeNotes
moved int
skipped int
changes json

Undo last organise

undo Destructive

Reverse the most recent organise in a folder, using the journal Folder Cleaner keeps.

Inputs

NameTypeRequired / defaultValues and notes
folder path required

Outputs

NameTypeNotes
restored int

Remove empty folders

remove_empty Destructive

Delete subfolders under a folder that contain no files (optionally nested, so a folder that only contains other empty folders counts too). Use --dry-run to preview.

Inputs

NameTypeRequired / defaultValues and notes
folder path required
recursive bool optional, default true

Outputs

NameTypeNotes
removed int
folders json

Use it

Organise folder

Command line

shell
python app.py --action organise --params '{"folder": "D:/path/to/folder"}'

# preview first - destructive action, nothing is changed:
python app.py --action organise --params '{"folder": "D:/path/to/folder"}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp
run_action("day-folder-cleaner", "organise", {"folder": "D:/path/to/folder"})

# preview first:
run_action("day-folder-cleaner", "organise", {"folder": "D:/path/to/folder"}, dry_run=true)

Workflow node

json
{
  "id": "n0",
  "app": "day-folder-cleaner",
  "action": "organise",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Undo last organise

Command line

shell
python app.py --action undo --params '{"folder": "D:/path/to/folder"}'

# preview first - destructive action, nothing is changed:
python app.py --action undo --params '{"folder": "D:/path/to/folder"}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp
run_action("day-folder-cleaner", "undo", {"folder": "D:/path/to/folder"})

# preview first:
run_action("day-folder-cleaner", "undo", {"folder": "D:/path/to/folder"}, dry_run=true)

Workflow node

json
{
  "id": "n0",
  "app": "day-folder-cleaner",
  "action": "undo",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Remove empty folders

Command line

shell
python app.py --action remove_empty --params '{"folder": "D:/path/to/folder"}'

# preview first - destructive action, nothing is changed:
python app.py --action remove_empty --params '{"folder": "D:/path/to/folder"}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp
run_action("day-folder-cleaner", "remove_empty", {"folder": "D:/path/to/folder"})

# preview first:
run_action("day-folder-cleaner", "remove_empty", {"folder": "D:/path/to/folder"}, dry_run=true)

Workflow node

json
{
  "id": "n0",
  "app": "day-folder-cleaner",
  "action": "remove_empty",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Example prompts

Things you can say to Claude, Cursor or Codex once the MCP server is registered.