Reference
Files
The tool Claude uses for the folders on your automation account: public addresses, private files, uploads and downloads.
One tool for the folders your workflows read and write (public/, private/, temp/). Claude asks you first before it makes a file public, moves one into public/, or deletes. Support Plus and above, with the owner's file folders switch on in Settings, Privacy.
Manage Files (public and private file folders)
awesomate_files · Can delete or overwrite: Claude asks first · part of automations
| Input | Type | |
|---|---|---|
action |
"status" | "list" | "search" | "download" | "upload" | "mkdir" | "move" | "make_public" | "make_private" | "delete" | "trash" | "empty_trash" | "extract" | "context_scan" |
|
path (optional) |
string |
A path in Files, starting public/, private/ or temp/. For upload, the target (a folder ending in / keeps the local name). |
to (optional) |
string |
move: the new Files path. download: where to save on this computer (file or folder; ~ expands). |
localPath (optional) |
string |
upload: the file on this computer (~ expands; prefer an absolute path). |
q (optional) |
string |
search: part of a file name (* and ? work as wildcards). |
top (optional) |
"public" | "private" | "temp" |
search: only this top folder. |
exts (optional) |
string[] |
search: only these extensions, e.g. [".png", ".jpg"]. |
overwrite (optional) |
boolean |
upload: replace a file already at path. download: replace a local file. |
confirm (optional) |
boolean |
true only after the user agreed: make_public, delete, empty_trash, and a move into public/. |
olderThanDays (optional) |
integer |
empty_trash: only what was deleted more than this many days ago. Leave out to empty everything. |
What Claude is told
The account's Files: the folders on their automation account (n8n) that workflows read and write, and that the hub shows at Knowledge, Files. Three top folders: public/ (every file has a public_url anyone can open with no login: images for a site or email, downloads, media a workflow made), private/ (only the account, its workflows and the hub) and temp/ (scratch space). Support Plus, Pro and Embedded; the owner must also have switched on "Open your automation account's file folders" in Settings, Privacy. Paths are relative to the files folder and start with the top folder, e.g. public/images/logo.png. action 'status': whether Files is on, why not, and storage used against the plan's limit: call this first. 'list' {path?}: one folder (no path = the top folders); files in public/ carry public_url. 'search' {q?, top?, exts?}: find files by name across the folders (first 200 matches; truncated:true means narrow it). 'download' {path, to?, overwrite?}: save a file to THIS computer (to = a local file or folder, default the working directory); never overwrites without overwrite:true. 'upload' {localPath, path, overwrite?}: send a file from this computer (max 50 MB each); path is the target file, or a folder ending in / to keep the name. Upload into public/ only when the user wants it publicly reachable. 'mkdir' {path}. 'move' {path, to}: rename or move; moving into public/ needs confirm:true. 'make_public' {path, confirm:true}: moves private/ or temp/ to the same place under public/ and returns its public_url: ASK the user first, anyone with the address can read it. 'make_private' {path}: moves it out of public/; its public address stops serving it within seconds (the hub clears Cloudflare's copy, and does the same after a delete or a replace), though a browser that already opened it may show its own copy until it expires, and a downloaded copy is not recalled. 'delete' {path, confirm:true}: moves to the trash (not erased); ask first. 'trash': what is in the trash, when each was deleted, and its total size. 'empty_trash' {olderThanDays?, confirm:true}: erases what is in the trash for good (or only what was deleted more than olderThanDays ago): the one thing here that cannot be undone, so show the user what will go and get a clear yes first. Moving or renaming changes the path, so tell the user any workflow, page or app using the old path or address needs the new one. 'extract' {path}: unpack a .zip into a folder beside it, named after it. 'context_scan' {path}: read one file (a brochure, an about-us document) and propose business details from it, saving nothing: fill are details not saved yet, conflict differ from what is saved; it needs the owner's Learn Business Context from My Files switch in Settings, Privacy. Saving those details is the owner's own click in the hub (Files, the file's menu, Scan for business context), never Claude's. Contents stream between this computer and the hub: never paste a file's contents into the conversation to move it. A 507 files_storage_full means the plan's Files allowance is used: say how much, offer to find large or old files to remove, and leave any plan change to the user.