All tools

onedrive_list_files

OneDrive · macOS · Windows

Effect: read (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

Lists files and folders in a OneDrive path. Use onedrive_root to find valid paths. Returns up to `limit` entries (default 1000, max 5000); large folders are truncated with a note — narrow the path for more specific results.

Required inputs

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — macOS
{
  "properties": {
    "limit": {
      "description": "Max entries to return (default 1000, max 5000). Folders with more entries are truncated; the response sets truncated=true and reports the total.",
      "type": "integer"
    },
    "path": {
      "description": "Absolute path to the OneDrive folder",
      "type": "string"
    }
  },
  "required": [
    "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.

{
  "path": "/Users/demo/OneDrive-Demo/Documents"
}

Windows

Purpose

Lists files and folders in a OneDrive path.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — Windows
{
  "properties": {
    "path": {
      "description": "Absolute path to a OneDrive folder",
      "type": "string"
    }
  },
  "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.

{
  "path": "Documents"
}