Skip to content
All tools

m365_save_attachment

Microsoft 365 · Windows

Effect: write (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

Windows

Purpose

Saves the attachments of a Microsoft 365 email to a folder: all of them, or one by attachment_id (the ids m365_read_email lists). An attachment that replaces a file of the same name: LMCP keeps a copy of that file first (in its backups folder) and the answer says where. An attached Outlook item or a link to a cloud file is not a file: it is not saved, and the answer says so. For classic Outlook, use outlook_save_attachment.

Required inputs

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.

Full input schema — Windows
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "attachment_id": {
      "description": "Save only this attachment (an id m365_read_email lists). Omit it to save all of them.",
      "type": "string"
    },
    "confirm": {
      "description": "Ignored; kept for older clients.",
      "type": "boolean"
    },
    "id": {
      "description": "The email message ID from m365_list_emails, m365_search_emails or m365_read_email",
      "type": "string"
    },
    "path": {
      "description": "Folder to save the attachments to",
      "type": "string"
    }
  },
  "required": [
    "id",
    "path"
  ],
  "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.

{
  "confirm": false,
  "id": "demo-item-001",
  "path": "C:\\Users\\demo\\Documents\\Attachments"
}