Files & Drive
beginFileUpload
Begin File Upload
To save a photo, video or any finished file, name where it is (a URL, a Cloud file, a Studio asset, an email attachment, or a path on your box); only type bytes for something you generated in the…
Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "save this attachment to my Cloud", and it calls beginFileUpload.
Example call
The MCP tools/call params, with the required arguments only.
{
"arguments": {
"byteSize": 1,
"contentSha": "<contentSha>",
"contentType": "<contentType>",
"name": "<name>"
},
"name": "beginFileUpload"
}Arguments
byteSizeintegerrequiredThe whole file's size in bytes (1 to 104857600, which is 100 MB).contentShastringrequiredThe whole file's SHA-256, as 64 hex characters.contentTypestringrequiredThe file's MIME type, e.g. "text/plain" or "application/pdf". Send "application/octet-stream" when unsure and the name's extension decides.folderIdstringoptionalThe folder the person named (folderId from listFiles). Omit to land the file in their Files root.namestringrequiredThe file name with its extension, e.g. "Autumn.pages".
Returns
The registry does not declare a return shape.
Declared limits
byteSize: minimum -9007199254740991byteSize: maximum 9007199254740991
Ask for it
The Cloud routes these requests to this verb.
- save this attachment to my Cloud
- put these files in Files > Poetry
- store the file I sent in The Cloud
Pair it with
The verbs that finish the job.
Questions
What does beginFileUpload do?
To save a photo, video or any finished file, name where it is (a URL, a Cloud file, a Studio asset, an email attachment, or a path on your box); only type bytes for something you generated in the… It is one of the tools The Cloud MCP server gives every connected AI.
How do I use beginFileUpload 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 "save this attachment to my Cloud", and it calls beginFileUpload.
Is beginFileUpload safe to let an AI call?
beginFileUpload changes your workspace. What an AI creates is Private until you share it.
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.