Skip to main content

Overview

The Microsoft 365 Mail server enables AI assistants to interact with Microsoft Outlook and Exchange Online, providing comprehensive email management, attachment handling, and shared mailbox capabilities through Microsoft Graph API.

How to Add Microsoft 365 Mail

The setup process varies depending on your Microsoft account type:

Personal Outlook Users

If you have a free outlook.com email address:
1

Add Server

Add the Microsoft 365 Mail server to your Nexus environment through the server directory.
2

Authorize

Simply log in and approve the OAuth consent request. No additional steps needed.Personal Outlook OAuth Consent
3

Test Connection

Try “Show me my latest 5 emails” to verify the connection works.

Microsoft 365 Business Users

For Microsoft 365 Business or Office 365 license holders, setup is straightforward:
1

Add Server

Add the Microsoft 365 Mail server to your Nexus environment through the server directory.
2

Authorize

Simply log in and approve the OAuth consent request. No admin approval needed for Mail.OAuth Consent Screen - Mail
3

Test Connection

Try “Show me my latest 5 emails” to verify the connection works.
Admin approval is NOT required for Mail. Unlike other Microsoft 365 apps (SharePoint, Teams, etc.), the Mail server works with direct user consent for both personal and business accounts.Personal vs Business Accounts: Mail is the ONLY Microsoft 365 app that works with free outlook.com accounts. All other apps (SharePoint, Teams, Calendar, OneDrive, etc.) require a Microsoft 365 Business license.Office 365 Note: Office 365 is the deprecated term for Microsoft 365. They refer to the same product platform.

What You Can Do

Email Management

Read, send, and organize emails with full inbox control

Attachment Handling

Upload, download, and manage email attachments programmatically

Folder Organization

Create, browse, and manage email folders for better organization

Shared Mailboxes

Access and manage shared mailboxes for team collaboration

Available Tools

Email Operations

List emails with filtering by folder, read status, and date range
Retrieve full email content including body and metadata
Send emails with HTML or plain text formatting
Create draft emails for review before sending
Delete emails from inbox or specific folders

Attachment Management

List all attachments in a specific email
Download and retrieve attachment content
Attach files to emails when sending

Folder Management

List all mail folders in your mailbox
Create new folders for email organization
Move emails between folders

Shared Mailboxes

Access shared mailboxes with delegated permissions
Send emails from shared mailbox addresses

Use Cases

Reading Mail

“Show me my latest 5 emails” - Quickly review recent messages. “List all unread emails from the last week” - Find specific messages with criteria.

Attachment Management

“Show me all emails with attachments” - Locate emails with files.

Sending Mail

“Send an email to [email protected] with subject ‘Meeting Follow-up’ and a brief summary of our discussion” - Compose and send emails directly.

Draft Creation

“Create a draft email to [email protected] about the Q4 planning session” - Prepare emails for review.

Folder Organization

“Move this email to my Archive folder” - Organize inbox programmatically.

Shared Mailbox Access

“Show me emails in the [email protected] shared mailbox” - Access team mailboxes.

Attachment Analysis

“Download the PDF from the latest email and summarize its contents” - Extract and analyze file contents.
Attachment size limit: Attachments are limited by Microsoft Graph API restrictions (typically 4MB for single request).Search limitations: Cannot combine search (search)withfilter(search) with filter (filter) parameters in the same query.HTML and plain text: Supports both HTML and plain text email formats.

Troubleshooting

Still seeing consent dialogs after authorization? This means permissions are missing or incomplete. For Business accounts, verify that your administrator has granted the necessary permissions in Microsoft Entra ID. For Personal accounts, try disconnecting and reconnecting the server. Authorization fails with “invalid_client” error? Ensure you’re using the correct account type. Personal outlook.com accounts cannot access other Microsoft 365 apps besides Mail.