> ## Documentation Index > Fetch the complete documentation index at: https://docs.alysio.ai/llms.txt > Use this file to discover all available pages before exploring further. # Outlook > Connect Alysio to Outlook using OAuth 2.0 ## Overview The Outlook integration connects Alysio to a user’s Outlook or Microsoft 365 mailbox so Alysio can retrieve and manage email, calendar events, and tasks through the Microsoft Graph API. Once connected, users can search emails, read message details, move emails to Deleted Items, schedule meetings, review their calendar, reschedule events, and manage tasks using natural language inside Alysio. The integration respects the user’s mailbox permissions and operates entirely within the scope of the authenticated Microsoft account. When requested, Alysio can also retrieve the mailbox timezone to ensure meeting times and task deadlines are displayed correctly. *** ## Supported Data and Capabilities ### User Profile and Timezone Retrieve the user’s Outlook profile and mailbox timezone. Supported operations include Getting the authenticated user profile\ Retrieving the mailbox timezone for proper event and task formatting *** ### Mail Retrieve and manage email messages. Supported operations include Listing mail folders\ Searching messages by sender, keyword, folder, date range, or read status\ Retrieving message details\ Moving messages to Deleted Items *** ### Calendar Retrieve and manage calendar events. Supported operations include Creating new events\ Listing events within a time range\ Viewing event details\ Rescheduling existing events\ Listing meeting attendees *** ### Tasks Retrieve and manage tasks within the user’s Microsoft To Do task list. Supported operations include Creating tasks\ Listing tasks with filters\ Retrieving task details\ Updating task attributes such as status, title, due date, or priority *** ## Authentication ### Method OAuth 2.0 using Microsoft identity platform Azure AD ### API Provider Microsoft Graph API ### Redirect URI Configured when setting up the Outlook integration in Alysio.\ The Azure AD application must allow this redirect URI. *** ## Token Handling OAuth tokens are stored securely and refreshed automatically. Each user connects their own Microsoft account, and all mailbox, calendar, and task actions are scoped to that user’s account. If the integration is disconnected or authorization is revoked, Outlook tools will no longer function until the integration is reconnected. *** ## Required Scopes The Outlook integration requires the following Microsoft Graph scopes. Calendars.ReadWrite\ Mail.Read\ Mail.ReadWrite\ Tasks.ReadWrite\ User.Read *** ## Scope Justification | Scope | Purpose | | ------------------- | -------------------------------------------- | | User.Read | Retrieve user profile and enable /me context | | Mail.Read | Search and retrieve email messages | | Mail.ReadWrite | Move messages to Deleted Items | | Calendars.ReadWrite | Create, list, and update calendar events | | Tasks.ReadWrite | Create, retrieve, and update tasks | *** ## MCP Tools The Outlook MCP provides tools that allow Alysio to interact with email, calendar, and tasks using natural language. *** ### get\_outlook\_user\_profile Returns the authenticated user’s Outlook profile. Example prompts What Outlook account is connected\ Show my Outlook profile *** ### get\_user\_outlook\_timezone Retrieves the mailbox timezone used for calendar and task formatting. Example prompts What timezone is my mailbox set to\ Use my timezone for calendar responses *** ### outlook\_get\_list\_of\_folders Returns the list of mail folders. Example prompts List my Outlook folders\ What folders do I have *** ### outlook\_search\_mail\_messages Searches mail messages using filters such as sender, folder, date range, or read status. Example prompts Find emails from [boss@company.com](mailto:boss@company.com)\ Search emails about the proposal *** ### outlook\_get\_mail\_message\_details Retrieves the full details of an email message by ID. Example prompts Open this email\ Show me the full message *** ### outlook\_trash\_mail\_message Moves an email message to Deleted Items. Example prompts Delete this email\ Move this message to trash *** ### outlook\_create\_calendar\_event Creates a new calendar event. Example prompts Schedule a meeting tomorrow at 2pm\ Create a meeting with Sarah and John *** ### outlook\_list\_calendar\_events Lists events within a specified date and time range. Example prompts What is on my calendar this week\ List meetings with [client@example.com](mailto:client@example.com) *** ### outlook\_get\_calendar\_event\_details Retrieves detailed information about a specific event. Example prompts Show this meeting\ Get details for event 123 *** ### outlook\_move\_calendar\_event Reschedules or updates an existing event. Example prompts Move this meeting to 3pm\ Reschedule the Q2 review to Friday *** ### outlook\_list\_calendar\_attendees Retrieves the list of attendees for a meeting. Example prompts Who is in this meeting\ List attendees for this event *** ### outlook\_create\_task Creates a new task. Example prompts Add a task to submit the report by Friday\ Create a high priority follow up task *** ### outlook\_list\_tasks Lists tasks with optional filters. Example prompts Show my tasks\ List my incomplete tasks *** ### outlook\_get\_task\_details Retrieves the full details of a task. Example prompts Show this task\ Get details for task 456 *** ### outlook\_update\_task Updates an existing task. Example prompts Mark this task complete\ Change the due date to next Monday *** ## App Behavior Outlook data is retrieved and updated on demand when users request information or actions involving email, calendar events, or tasks. Alysio does not continuously sync mailbox data. Each request triggers a Microsoft Graph API call using the user’s OAuth credential. This ensures all activity is scoped to explicit user actions and respects mailbox permissions. *** ## Example Workflow User asks What is on my calendar today Alysio routes the request to the Outlook MCP. The MCP retrieves the user’s timezone using get\_user\_outlook\_timezone. The MCP retrieves calendar events for today using outlook\_list\_calendar\_events with the correct timezone. Microsoft Graph returns the events. Alysio displays the events in the conversation interface. *** ## Troubleshooting ### Outlook Not Connected The Outlook integration has not been authorized. Solution\ Reconnect Outlook under Settings → Integrations and complete OAuth authorization. *** ### 401 Unauthorized The OAuth token may be invalid, expired, or revoked. Solution\ Reconnect the Outlook integration to generate a new token. *** ### 403 Forbidden The Azure AD application may be missing required permissions. Solution\ Ensure the application includes Mail.Read, Mail.ReadWrite, Calendars.ReadWrite, Tasks.ReadWrite, and User.Read. *** ### Incorrect Timezone Calendar times may appear incorrect if the mailbox timezone is not used. Solution\ Retrieve the timezone using get\_user\_outlook\_timezone before formatting event times. *** ### Tasks Not Appearing Tasks are created in the default Microsoft To Do task list. Solution\ Ensure the Microsoft account has a default task list configured. *** ### Message or Event Not Found The item ID may be outdated or the item may have moved. Solution\ Search again to retrieve the updated message or event ID. *** ## Support For help configuring or troubleshooting the Outlook integration, contact [support@alysio.ai](mailto:support@alysio.ai)