Microsoft OneDrive

Microsoft OneDrive toolkit for Arcade provides 16 LLM-callable tools that read, write, organize, and share files in a user's OneDrive via Microsoft Graph.

Capabilities

Drive & item inspection — retrieve drive metadata and quota, resolve individual item metadata by ID, list folder contents, and identify the current user/confirm access.
File & folder operations — create folders, copy (with synchronous polling to completion), move/rename (single or batch), and delete (single or batch) items; locked items are reported as retryable rather than failing the batch.
File content access — download file contents as base64 with offset-based paging for large files; search the drive index by keyword; scan for byte-identical duplicate files across a folder subtree.
Sharing & permissions — generate share links (view or edit, tenant-scoped or public), list all current grants on an item, and revoke individual or all anonymous grants.
Async operation support — initiate long-running copies and poll their status via a dedicated token-based status tool.
Structured error handling — stale or mistyped item/permission IDs return a typed not_found envelope (retryable: false) so callers can branch programmatically instead of catching exceptions.

OAuth

This toolkit authenticates via OAuth 2.0 through the Microsoft provider. See the Arcade Microsoft auth provider docs for setup instructions, required app registrations, and tenant configuration.

	Tool name	Description	Secrets
	MicrosoftOnedrive.CopyItem	Copy a file or folder and wait for the copy to finish, returning the new item. Microsoft Graph performs copies asynchronously; this tool polls the operation to completion within a bounded budget so the caller receives the finished item directly. A stale or mistyped source id returns a structured not_found envelope (status "not_found", retryable false) rather than a fatal error, so the caller can branch on the field.
	MicrosoftOnedrive.CreateFolder	Create a new folder in OneDrive.
	MicrosoftOnedrive.CreateShareLink	Create a share link for a OneDrive item. Set link_type to EDIT to let recipients change the item; use scope ORGANIZATION to keep the link inside the tenant instead of anyone-with-the-link.
	MicrosoftOnedrive.DeleteItem	Delete one or more files or folders from OneDrive in a single call. An item open for editing elsewhere is reported as locked and retryable rather than failing the whole batch; every requested id is attempted.
	MicrosoftOnedrive.DownloadFile	Download a OneDrive file's content as base64, paging large files by byte offset. Files at or under the per-call cap return fully in one call; for larger files, re-call with offset set to the returned next_offset until is_final is true. A stale or mistyped id returns a structured not_found envelope (status "not_found", retryable false) rather than a fatal error, so the caller can branch on the field.
	MicrosoftOnedrive.FindDuplicateFiles	Find files that are byte-identical copies of each other across folders in one call. Groups examined files by content fingerprint and returns only the fingerprints with two or more copies, each group flagging the copy to keep and the rest as deletion candidates, so a de-dup cleanup can act without listing and grouping by hash manually. The scan walks the drive directly rather than the search index, so a file copied moments ago is seen immediately. Supply folder_id to scope the scan to a subtree (much more likely to be complete, though still bounded by limit and an internal walk cap); keywords further restrict to files whose name contains the term. When truncated is true, truncated_warning explains what was missed and how to refocus.
	MicrosoftOnedrive.GetCopyStatus	Check status of an async copy operation using the token returned by copy_item.
	MicrosoftOnedrive.GetItem	Resolve a single OneDrive file or folder's metadata directly from its id. A stale or mistyped id returns a structured not_found envelope (status "not_found", retryable false) rather than a fatal error, so the caller can branch on the field.
	MicrosoftOnedrive.GetMyDrive	Get metadata about the user's OneDrive (id, name, quota, owner).
	MicrosoftOnedrive.GetSharedWithMe	List files shared with the current user.
	MicrosoftOnedrive.ListFolderItems	List files and folders in a OneDrive folder. Lists root if folder_id is omitted.
	MicrosoftOnedrive.ListItemPermissions	List who can currently access a OneDrive item: every share link and direct grant on it. Use this to answer "who can see this?" and to find the permission_id needed to revoke a grant. A stale or mistyped id returns a structured not_found envelope (status "not_found", retryable false) rather than a fatal error, so the caller can branch on the field. When has_more is true, pass next_token back unchanged to fetch the remaining grants.
	MicrosoftOnedrive.MoveItem	Move and/or rename one or more files or folders in OneDrive in a single call. Provide new_parent_id to relocate items, new_name (single item only) to rename in place, or both. At least one must be supplied. An item open for editing elsewhere is reported as locked and retryable rather than failing the whole batch.
	MicrosoftOnedrive.RevokeItemPermission	Revoke one or all anonymous sharing grants on a OneDrive item. Single-grant mode (revoke_all_anonymous=false): removes the grant identified by permission_id. An unknown item or permission id returns a structured not_found envelope rather than a fatal error. To revoke an inherited grant, target the parent folder instead. Bulk mode (revoke_all_anonymous=true): removes every anonymous (anyone-with-the-link) grant on the item in one call. revoked_count reports how many were removed; 0 means none existed.
	MicrosoftOnedrive.SearchItems	Search for files and folders in the user's OneDrive. It may take a few seconds to minutes for the search index to update with newly created items.
	MicrosoftOnedrive.WhoAmI	Identify the current user and confirm OneDrive access for orientation.

Capabilities

OAuth

Available tools(16)

Get Building