auth_start
Starts Outlook authentication flow when an authentication error occurs or user requests re-authentication. Use only when needed, not proactively.
Instructions
Start the Outlook authentication flow. IMPORTANT: Only call this tool when you receive an authentication error (e.g. 'Not authenticated') from another tool, or when the user explicitly requests re-authentication. Do NOT call this proactively before using other Outlook tools — they automatically use the stored token. If a valid token already exists, this returns immediately without starting a new auth flow.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "auth_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Force re-authentication even if a valid token exists (default: false) | |
| clientId | No | Azure AD application client ID (optional, uses Microsoft Graph Explorer by default) | |
| tenantId | No | Azure AD tenant ID (optional, uses 'common' by default) |