Skip to content
All tools

onedrive_move_file

OneDrive · macOS · 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.

macOS

Purpose

Moves or renames a file or folder inside the OneDrive folder synced on this Mac; OneDrive syncs the change to the cloud. Source and destination must both be inside OneDrive. If the destination is an existing folder, the item is moved INTO it and keeps its name. Never overwrites: it fails if something already exists at the destination. Creates missing parent folders of the destination. Called without confirm it returns a preview; pass confirm=true to move.

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 — macOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to move",
      "type": "boolean"
    },
    "destination": {
      "description": "Destination path",
      "type": "string"
    },
    "source": {
      "description": "Source path",
      "type": "string"
    }
  },
  "required": [
    "source",
    "destination"
  ],
  "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,
  "destination": "Documents/Archive/meeting-notes.txt",
  "source": "Documents/meeting-notes.txt"
}

Windows

Purpose

Moves or renames one file or folder on the local disk. It renames the local path and never calls the OneDrive service. Both paths must be inside a OneDrive folder (onedrive_root lists them): anything else is refused with or without confirm, and so is a OneDrive folder itself as the source. If `destination` is an existing folder, the item is moved INTO it and keeps its name (the preview shows the resulting path); otherwise `destination` is the full new path including the new name. Never overwrites: if something already exists at the resulting path (a file or a folder) the call is refused, with or without confirm, and nothing is replaced. A source that does not exist is refused too. Without confirm=true nothing moves: the call returns a preview with the source and the resulting path. With confirm=true, missing parent folders of the destination are created and the item is moved. There is no undo; to revert, move it back.

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": {
    "confirm": {
      "description": "Must be true to execute",
      "type": "boolean"
    },
    "destination": {
      "description": "New path, or an existing folder to move the item into",
      "type": "string"
    },
    "source": {
      "description": "Current path",
      "type": "string"
    }
  },
  "required": [
    "source",
    "destination"
  ],
  "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,
  "destination": "Documents/Archive/meeting-notes.txt",
  "source": "Documents/meeting-notes.txt"
}