Files & Drive
fetchFileToMachine
Fetch File To Machine
Fetch one Cloud file you can read into Downloads on one of your own online MachineSync boxes, without its URL, credential or bytes passing through the chat.
Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "download this Cloud file to my MacBook", and it calls fetchFileToMachine.
Example call
The MCP tools/call params, with the required arguments only.
{
"arguments": {
"confirm": true,
"destinationPath": "<destinationPath>",
"fileId": "<fileId>"
},
"name": "fetchFileToMachine"
}Arguments
confirmbooleanrequiredMust be true. Pass only after the user explicitly agrees to put this file at this path on this machine.destinationPathstringrequiredAbsolute destination path inside ~/Downloads, such as ~/Downloads/report.pdf.expectedSha256stringoptionalOptional expected SHA-256. A mismatch leaves no destination file.fileIdstringrequiredA Cloud file you can read (fileId from listFiles).machineIdstringoptionalWhich owned online machine receives the file (machineId from listMachines).
Returns
Returns the final path, byte count and SHA-256.
Ask for it
The Cloud routes these requests to this verb.
- download this Cloud file to my MacBook
- put this file in Downloads
Pair it with
The verbs that finish the job.
Questions
What does fetchFileToMachine do?
Fetch one Cloud file you can read into Downloads on one of your own online MachineSync boxes, without its URL, credential or bytes passing through the chat. It is one of the tools The Cloud MCP server gives every connected AI.
How do I use fetchFileToMachine from Claude or ChatGPT?
Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "download this Cloud file to my MacBook", and it calls fetchFileToMachine.
Is fetchFileToMachine safe to let an AI call?
fetchFileToMachine deletes or sends, and calling it again does not undo it, so a careful client confirms with you before it runs. It reaches a system outside The Cloud on your behalf.
Connect
One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.