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 profileRetrieving the mailbox timezone for proper event and task formatting
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 eventsListing 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 tasksListing 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 ADAPI Provider
Microsoft Graph APIRedirect 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.ReadWriteMail.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 connectedShow 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 toUse my timezone for calendar responses
outlook_get_list_of_folders
Returns the list of mail folders. Example prompts List my Outlook foldersWhat 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.comSearch emails about the proposal
outlook_get_mail_message_details
Retrieves the full details of an email message by ID. Example prompts Open this emailShow me the full message
outlook_trash_mail_message
Moves an email message to Deleted Items. Example prompts Delete this emailMove this message to trash
outlook_create_calendar_event
Creates a new calendar event. Example prompts Schedule a meeting tomorrow at 2pmCreate 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 weekList meetings with client@example.com
outlook_get_calendar_event_details
Retrieves detailed information about a specific event. Example prompts Show this meetingGet details for event 123
outlook_move_calendar_event
Reschedules or updates an existing event. Example prompts Move this meeting to 3pmReschedule the Q2 review to Friday
outlook_list_calendar_attendees
Retrieves the list of attendees for a meeting. Example prompts Who is in this meetingList attendees for this event
outlook_create_task
Creates a new task. Example prompts Add a task to submit the report by FridayCreate a high priority follow up task
outlook_list_tasks
Lists tasks with optional filters. Example prompts Show my tasksList my incomplete tasks
outlook_get_task_details
Retrieves the full details of a task. Example prompts Show this taskGet details for task 456
outlook_update_task
Updates an existing task. Example prompts Mark this task completeChange 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. SolutionReconnect Outlook under Settings → Integrations and complete OAuth authorization.
401 Unauthorized
The OAuth token may be invalid, expired, or revoked. SolutionReconnect the Outlook integration to generate a new token.
403 Forbidden
The Azure AD application may be missing required permissions. SolutionEnsure 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. SolutionRetrieve 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. SolutionEnsure 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. SolutionSearch again to retrieve the updated message or event ID.