OneDrive Tools¶

janito provides tools for interacting with Microsoft OneDrive using the Microsoft Graph API.

Setup¶

1. Register an Azure AD Application¶

Go to Azure Portal → Azure Active Directory → App registrations
Click "New registration"
Set a name (e.g., "janito OneDrive")
Choose supported account types:
Personal accounts: Select "Accounts in any personal Microsoft account"
Work/School accounts: Select "Accounts in any organizational directory"
Click "Register"
Copy the "Application (client) ID"

2. Configure Secrets¶

# Set your client ID
janito --set-secret azure_client_id=your-client-id

3. Authenticate (One-Time)¶

janito --onedrive-auth

You'll see instructions:

Step 1: Open this URL in your browser:
   https://microsoft.com/devicelogin

Step 2: Enter this code:
   ABC123XYZ

Step 3: Sign in with your Microsoft account
Step 4: Click 'Continue' to grant permissions

Waiting for authentication...
✓ Authentication successful!

Available Tools¶

Tool	Description	Permissions
`ListOneDriveFiles`	List files and folders	`r`
`SearchOneDriveFiles`	Search for files	`r`
`ReadOneDriveFile`	Get file metadata	`r`
`DownloadOneDriveFile`	Download file content	`r`
`UploadOneDriveFile`	Upload files	`w`
`DeleteOneDriveFile`	Delete files/folders	`rw`
`CreateOneDriveFolder`	Create folders	`w`
`GetOneDriveShareLink`	Create share links	`r`

Usage¶

Enable OneDrive Tools¶

# Interactive chat with OneDrive
janito --onedrive

# Single prompt with OneDrive
janito --onedrive "List my files in Documents folder"

Example Prompts¶

# List files in a folder
janito --onedrive "List my files in Documents"

# Search for files
janito --onedrive "Find all PDF files in my OneDrive"

# Download a file
janito --onedrive "Download the quarterly report from the Finance folder"

# Upload a file
janito --onedrive "Upload notes.txt to Documents"

# Create a share link
janito --onedrive "Create a share link for report.pdf"

Authentication Commands¶

Command	Description
`janito --onedrive-auth`	Authenticate with Microsoft
`janito --onedrive-status`	Check authentication status
`janito --onedrive-logout`	Sign out and clear credentials

Check Status¶

janito --onedrive-status

Displays authentication state, account email, type, and token expiration.

Logout¶

janito --onedrive-logout

Clears stored tokens. You'll need to re-authenticate with --onedrive-auth to use OneDrive tools again.

Troubleshooting¶

"azure_client_id not configured"¶

Run: janito --set-secret azure_client_id=your-client-id

"Not authenticated"¶

Run: janito --onedrive-auth

"Refresh token expired"¶

Run: janito --onedrive-auth to re-authenticate

File Size Limits¶

Simple upload: Up to 4MB
Resumable upload: Supports large files (automatic)

More Info¶

For CLI access, see janito/tools/README.onedrive.md