1. Docs
2. /
3. Tool reference
4. /
5. Email
6. /
7. saveEmailAttachment

Email

saveEmailAttachment

Save Email Attachment

Save one attachment or inline image from a Gmail message as a Cloud file.

writeexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "save the images from that email", and it calls saveEmailAttachment.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "messageId": "<messageId>"
  },
  "name": "saveEmailAttachment"
}

Arguments

• accountIdstringoptionalConnected account this acts on: an accountId or email from listMailAccounts. Omit for the primary account. Pass the SAME account you found the message / draft / label in: a Gmail id is per-account, so aiming a non-primary id at the…
• attachmentIdstringoptionalThe attachmentId from readEmail's `attachments` or `inlineImages`. Gmail re-mints it per read, so pass partId and filename too.
• filenamestringoptionalThe part's filename exactly as readEmail listed it
• messageIdstringrequiredThe Gmail message ID
• namestringoptionalFilename for the Cloud file. Defaults to the sender's filename, or inline-<contentId>.<ext> for an embedded image.
• partIdstringoptionalThe part's partId from readEmail (stable across reads)
• sizeintegeroptionalThe part's size in bytes from readEmail; pairs with filename

Returns

The registry does not declare a return shape.

Declared limits

• attachmentId: minimum length 1
• filename: minimum length 1
• messageId: minimum length 1
• name: minimum length 1
• name: maximum length 200
• partId: minimum length 1
• size: minimum 0
• size: maximum 9007199254740991

Ask for it

The Cloud routes these requests to this verb.

• save the images from that email
• grab the attachment
• save the invite
• save the photo I emailed myself
• pull the screenshots out of the email I sent
• reuse the pictures from that email

Pair it with

The verbs that finish the job.

• readEmail
• readFile
• sendEmail
• createDraft

Questions

• What does saveEmailAttachment do?

  Save one attachment or inline image from a Gmail message as a Cloud file. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use saveEmailAttachment 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 the images from that email", and it calls saveEmailAttachment.

• Is saveEmailAttachment safe to let an AI call?

  saveEmailAttachment changes your workspace. What an AI creates is Private until you share it. 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.