Files & Drive
beginFileUpload
Begin File Upload
Open a staged upload that files one attachment (a .txt, .pages, .pdf, photo, recording and so on) into Cloud Files, when you hold the file's bytes and the person asked you to keep it.
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 3000000).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?
Open a staged upload that files one attachment (a .txt, .pages, .pdf, photo, recording and so on) into Cloud Files, when you hold the file's bytes and the person asked you to keep it. 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.