auth
Authenticate with Microsoft Graph by starting a login flow, checking status, completing browser verification, or logging out.
Instructions
Manage authentication with Microsoft Graph. Four simple actions:
• 'start' - Start login flow, returns verification URL and code to enter in browser • 'complete' - Complete login after browser authentication (auto-loads device code) • 'check_status' - Check auth status: returns authenticated or need login • 'logout' - Clear all authentication tokens
WHEN AUTHENTICATION NEEDED: Always try 'check_status' FIRST. If it fails (no token or expired), then call 'start'.
WORKFLOW:
Call auth action='start' → get URL and code
Open URL in browser, enter the code, complete Microsoft login
Call auth action='complete' → authentication finished
AUTO-REFRESH: Access tokens auto-refresh when expired (no user action needed). Refresh tokens are valid for ~90 days.
Returns:
check_status: {status: string, authenticated: boolean, message: string}
start: {status: string, verification_uri: string, user_code: string, message: string}
complete: {status: string, authenticated: boolean, message: string}
logout: {status: string, authenticated: false, message: string}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action: 'start' to begin login (get URL/code), 'complete' to finish login after browser auth, 'check_status' to check authentication status, 'logout' to sign out |