edit_file

Apply multiple text replacements to specified files using a list of edits, generate a unified diff to preview changes, and atomically update the file. Ensures compliance with directory restrictions and UTF-8 encoding.

Instructions

Apply multiple text replacements to a file and return a unified diff.

Args: path (str): File path to edit (absolute or relative to allowed directories) edits (List[Dict[str, str]]): List of edit operations, each with 'oldText' and 'newText' keys

Returns: str: Unified diff showing changes made, or error message if failed

Note:

- Path must be within allowed directory roots
- File must be a UTF-8 text file
- Edits are applied sequentially in the order provided
- Each 'oldText' must match exactly (first occurrence is replaced)
- Returns unified diff format showing before/after changes
- File is atomically updated using temporary file
- If no changes made, returns 'No changes made.'

Input Schema

Name	Required	Description	Default
`edits`	Yes
`path`	Yes

Input Schema (JSON Schema)

{
  "properties": {
    "edits": {
      "items": {
        "additionalProperties": {
          "type": "string"
        },
        "type": "object"
      },
      "title": "Edits",
      "type": "array"
    },
    "path": {
      "title": "Path",
      "type": "string"
    }
  },
  "required": [
    "path",
    "edits"
  ],
  "type": "object"
}

Filesystem MCP Server

edit_file

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Filesystem MCP Server

Related Tools

MCP directory API