mcp-synology

List all shared folders on the NAS. This is the starting point for file navigation — call this first to discover available paths.

List files and folders in a directory. Supports glob pattern filtering, file type filtering, sorting, and pagination.

List the contents of a shared folder's recycle bin. Shows recently deleted files that can be restored.

Search recursively for files by keyword, extension, or size range. The pattern parameter is a keyword/substring match on filenames (not glob). Use extension for file type filtering (e.g., extension="mkv"). Accepts human-readable sizes like "500MB". For directory contents or sizes, use list_files or get_dir_size instead.

Get detailed metadata for specific files or folders: size, owner, timestamps, permissions, and real path.

Calculate the total size of a directory, including all files and subdirectories. Returns total size, file count, and directory count. This is the best tool for answering 'how much space does X use' questions.

Download a NAS file to a local directory on this machine. Provide the NAS file path. dest_folder is optional if default_download_dir is configured. Does not overwrite existing local files by default.