Filesystem

MCP server for local filesystem access. Based on the Anthropic reference MCP server. Read files, write files, search directories, and manage filesystem operations with configurable path restrictions for safety.

Useful for processing documents, parsing log files, managing configuration, generating reports to disk, and any workflow that needs to read or write local files.

Install

amodal install mcp filesystem

Tools exposed

• read_file — Read the complete contents of a file. Returns text content with UTF-8 encoding. Supports any text-based file format.
• read_multiple_files — Read multiple files in a single call. Returns contents keyed by path. Failed reads return error messages per file without blocking others.
• write_file — Write content to a file. Creates the file if it doesn't exist. Overwrites if it does. Creates parent directories as needed.
• edit_file — Apply targeted edits to a file using search-and-replace. Safer than full rewrites for modifying existing files.
• list_directory — List files and subdirectories at a given path. Returns names with type indicators (file vs directory).
• directory_tree — Recursive directory listing as a tree structure. Configurable depth limit.
• move_file — Move or rename a file or directory.
• search_files — Search for files matching a pattern. Supports glob patterns and recursive search.
• get_file_info — Get metadata: size, modified time, permissions, file type.

Configuration

env:
  MCP_FILESYSTEM_ALLOWED_PATHS: "/home/user/documents,/var/log"

• MCP_FILESYSTEM_ALLOWED_PATHS — Comma-separated list of directory paths the server is allowed to access. All operations are restricted to these paths and their subdirectories. Required.

Example usage

• "Read the contents of /var/log/app.log and summarize any errors from today"
• "Search for all .env files under /home/user/projects"
• "Write this CSV report to /home/user/reports/monthly-summary.csv"
• "List everything in the config directory and show me any YAML files"