Mass Renamer v1.0.0

Files & backup mass-renamer 3 actions MCP

Batch-rename files in a folder: add a prefix, find/replace in names, or number them sequentially. Every rename can be previewed as a dry-run first.

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: previewrenameundo

Preview names

preview

Show what the current rename settings would produce, without touching any file.

Inputs

Name	Type	Required / default
`folder`	path	required
`prefix`	string	optional, default `""`
`find`	string	optional, default `""`
`replace`	string	optional, default `""`
`number`	bool	optional, default `false`
`start`	int	optional, default `1`
`pad`	int	optional, default `3`
`pattern`	string	optional, default `*`

Outputs

Name	Type	Notes
`plan`	json

Rename files

rename Destructive

Apply the rename to the files in the folder. Add a prefix, replace text in the name, and/or number them. Use --dry-run to preview.

Inputs

Name	Type	Required / default
`folder`	path	required
`prefix`	string	optional, default `""`
`find`	string	optional, default `""`
`replace`	string	optional, default `""`
`number`	bool	optional, default `false`
`start`	int	optional, default `1`
`pad`	int	optional, default `3`
`pattern`	string	optional, default `*`

Outputs

Name	Type	Notes
`renamed`	int
`changes`	json

Undo last rename

undo Destructive

Reverse the most recent rename in a folder, using the journal Mass Renamer keeps.

Inputs

Name	Type	Required / default	Values and notes
`folder`	path	required

Outputs

Name	Type	Notes
`restored`	int

Use it

Preview names

Command line

shell

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

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("mass-renamer", "preview", {"folder": "D:/path/to/folder"})

Workflow node

json

{
  "id": "n0",
  "app": "mass-renamer",
  "action": "preview",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Rename files

Command line

shell

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

# preview first - destructive action, nothing is changed:
python app.py --action rename --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("mass-renamer", "rename", {"folder": "D:/path/to/folder"})

# preview first:
run_action("mass-renamer", "rename", {"folder": "D:/path/to/folder"}, dry_run=true)

Workflow node

json

{
  "id": "n0",
  "app": "mass-renamer",
  "action": "rename",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Undo last rename

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("mass-renamer", "undo", {"folder": "D:/path/to/folder"})

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

Workflow node

json

{
  "id": "n0",
  "app": "mass-renamer",
  "action": "undo",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Example prompts

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

add the prefix 'trip_' to every file in D:/photos
number the files in this folder starting at 1 with 4 digits
replace 'IMG' with 'render' in all names, preview first