sftp
Transfer files and manage remote filesystems over SSH using SFTP. Supports upload, download, directory operations, rename, chmod, and async transfers.
Instructions
Transfer files and manage remote filesystems over SSH (SFTP protocol). Reuses SSH session pool — same authentication and session reuse as the ssh tool. Operations: upload (local to remote), download (remote to local), ls, stat, mkdir, rm, chmod, rename. Async operations: upload_async, download_async (returns transfer_id immediately), status (check progress), cancel. Max file transfer size: 2 GB. Use overwrite=true to replace existing files. Recursive delete is limited to 10,000 items for safety.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | SSH server hostname or IP address (IPv4 or IPv6),required | |
| port | No | SSH port number. Default: 22 | |
| user | Yes | SSH username,required | |
| password | No | Password for authentication | |
| key_file | No | Path to SSH private key file (e.g. ~/.ssh/id_rsa) | |
| passphrase | No | Passphrase for encrypted private key | |
| use_agent | No | Use SSH agent for authentication: true or false. Default: true if no other auth method specified | |
| host_key_check | No | Host key verification: strict, tofu (default), none | |
| jump_host | No | Jump/bastion host for ProxyJump (hostname or IP) | |
| jump_port | No | Jump host SSH port. Default: 22 | |
| jump_user | No | Jump host username. Default: same as user | |
| jump_password | No | Jump host password. Default: same as password | |
| jump_key_file | No | Jump host SSH private key file. Default: same as key_file | |
| jump_passphrase | No | Jump host key passphrase. Default: same as passphrase | |
| operation | Yes | SFTP operation: upload, download, upload_async, download_async, status, cancel, ls, stat, mkdir, rm, chmod, rename,required | |
| local_path | No | Local file path (for upload/download) | |
| remote_path | No | Remote file/directory path | |
| local | No | Alias for local_path | |
| remote | No | Alias for remote_path | |
| recursive | No | Recursive operation (mkdir: create parents, rm: remove directory tree): true or false. Default: false | |
| mode | No | File permission mode in octal (e.g. 0755). Used by chmod | |
| new_path | No | New remote path (for rename operation) | |
| overwrite | No | Overwrite existing file on upload/download: true or false. Default: false | |
| transfer_id | No | Transfer ID for status/cancel operations (returned by upload_async/download_async) |