@apilium/onedrive

OneDrive file management skill for Mayros -- files, folders, sharing, and search via Microsoft Graph API.

Installation

Copy this skill directory into your Mayros skills folder:

cp -r skills/onedrive ~/.mayros/skills/onedrive

Or install via the Mayros CLI:

mayros skill install @apilium/onedrive

Configuration

This skill requires a Microsoft Graph API access token.

Set the access token

export MS_GRAPH_ACCESS_TOKEN="your-token-here"

Quick token via Azure CLI

If you have the Azure CLI installed:

export MS_GRAPH_ACCESS_TOKEN="$(az account get-access-token --resource https://graph.microsoft.com --query accessToken -o tsv)"

Required permissions (delegated)

• Files.Read
• Files.ReadWrite

Usage

Once configured, the agent can:

• List files: Browse root or specific folders
• Search files: Find files by keyword across OneDrive
• Download files: Retrieve file content
• Upload files: Upload small files (< 4 MB direct, larger via upload session)
• Create folders: Organize files into new directories
• Share files: Create view or edit sharing links
• Delete items: Remove files or folders (with user confirmation)

Example prompts

"List my files in OneDrive"
"Search for the quarterly report document"
"Upload this file to my Documents folder"
"Create a sharing link for the presentation"
"Delete the old backup folder"
"Show me files modified in the last week"

Semantic Predicates

File Type Annotations

The skill automatically classifies files:

• document -- Office documents, PDFs, text files
• image -- JPEG, PNG, GIF, and other image formats
• folder -- Directories
• other -- Videos, archives, and other formats

Recency Annotations

• recent -- Modified within 24 hours
• normal -- Modified within 30 days
• stale -- Not modified in over 30 days

License

MIT