save_attachment

macOS

Purpose

Saves an attachment from an email to disk. Requires confirm=true; without it you get a preview of where the file would be written. Pass account= (and mailbox= if known, both from list_emails/search_emails) so the lookup targets one account instead of scanning all of them.

Required inputs

• message_id
• attachment_name

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

• Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

{
  "properties": {
    "account": {
      "type": "string"
    },
    "attachment_name": {
      "type": "string"
    },
    "confirm": {
      "default": "false",
      "type": "boolean"
    },
    "destination": {
      "default": "~/Downloads",
      "type": "string"
    },
    "mailbox": {
      "type": "string"
    },
    "message_id": {
      "type": "string"
    }
  },
  "required": [
    "message_id",
    "attachment_name"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "attachment_name": "launch-checklist.pdf",
  "confirm": false,
  "message_id": "demo-message-001"
}