playbooks

home / mcp / multi edit mcp server

Multi Edit MCP Server

Provides atomic, multi-file and multi-edit capabilities for batch find-and-replace operations within Claude environments.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "eaisdevelopment-mcp-multi-edit": {
      "command": "npx",
      "args": [
        "-y",
        "@essentialai/mcp-multi-edit"
      ]
    }
  }
}

You can perform multiple find-and-replace edits in a single, atomic operation using the Multi Edit MCP Server. It batches edits across one or more files so either all changes apply together or none apply, reducing token usage and latency when refactoring or renaming across a project.

How to use

To use the Multi Edit MCP Server, connect it through your MCP client as a stdio transport tool. You have two tools available: one for edits within a single file and another for coordinated edits across multiple files.

How to install

Prepare your environment with the following steps.

claude mcp add --transport stdio multi-edit -- npx -y @essentialai/mcp-multi-edit

After installing

Restart Claude Code to establish the new MCP tool connection. Then run the MCP check to verify the server is connected.

/exit
claude
/mcp

Practical usage patterns

Use the single-file tool when you need multiple replacements within one file. Edits are applied in order and committed atomically, meaning either all replacements happen or none do.

Use the multi-file tool when you are refactoring across several files. If any file fails, all previously changed files are rolled back to preserve consistency.

What you can accomplish

- Batch multiple replacements in a single file with guaranteed atomicity.

- Coordinate edits across multiple files with automatic rollback on failure.

- Preview changes with a dry-run option before applying updates.

Available tools

multi_edit

Batch multiple find-and-replace operations on a single file. Edits are applied sequentially and atomically.

multi_edit_files

Coordinate edits across multiple files so all changes apply atomically; if any edit fails, all edits across files are rolled back.