Skip to Content

Filesystem

Use the local filesystem connected through Edge Tunnel to read, create, edit, and move files and directories.

Key Features

  • Read files and read multiple files at once
  • Create, overwrite, and line-edit files
  • Create directories and browse directory lists or trees
  • Move files and directories
  • Search files and inspect metadata

Basic Information

Authentication Method

No separate authentication is required.

Supported Scope

This integration only works inside allowed directories accessible through Edge Tunnel.

Supported MCP Tools

File Reading Tools

read_file

Reads the full content of a text file or selected head/tail lines. Use download_file for binary files (PDF, DOCX, and XLSX).

download_file

Downloads PDF, DOCX, and XLSX files for reading, summarization, and analysis.

You can make requests such as “Read this PDF and summarize the key points.” Files up to 50 MiB are supported.

read_multiple_files

Reads multiple files in a single request.

get_file_info

Retrieves metadata for a file or directory, such as size, creation and modification times, and permissions.

File Modification Tools

write_file

Creates a new file from inline text or completely overwrites an existing text file.

upload_file

When you request a task in chat, a binary file on a connected local PC or mounted file server can be read, used to create a new file, and saved to the path you specify.

  • Supports saving XLSX, PDF, and DOCX binary files.
  • Existing files cannot be edited or overwritten. The result is always saved as a new file.
  • The maximum file size is 50 MiB.

edit_file

Finds exact matching text, applies line-based edits, and returns a diff.

move_file

Moves or renames a file or directory.

Directory Tools

create_directory

Creates a new directory. Nested directories can be created in one operation.

list_directory

Lists files and directories under the specified path.

list_directory_with_sizes

Lists files and directories under the specified path with size information.

directory_tree

Retrieves the directory tree under the specified path as a JSON structure.

search_files

Searches for files or directories whose names match a pattern under the specified path.

Usage Examples

  • If you ask, “Find the README file in the project folder and summarize it,” the search_files and read_file tools find the file and read its contents.
  • The download_file and upload_file tools can read an XLSX application form on your local PC, create a new form filled with the information you provide, and save it to the local path you specify.

Notes

  • Paths outside allowed directories cannot be accessed.
  • write_file, edit_file, and move_file can modify file contents or paths, so review the request before using them.
  • Operations may be restricted by the Edge Tunnel connection state and local filesystem permissions.
Last updated on