Read Microsoft Outlook Emails

Microsoft Outlook Email Reader is a LlamaIndex integration that retrieves emails from Outlook mailboxes and indexes their subject lines and body content. It connects via Microsoft Graph API using Azure AD (Microsoft Entra ID) app authentication to fetch emails from specified folders.

Use this reader when you need to programmatically access and index Outlook email content. It performs on-demand retrieval of emails from specified folders in an Outlook mailbox.

Do NOT use this reader if you need real-time email monitoring or webhook-based triggers - it performs on-demand retrieval rather than continuous monitoring.

You provide five required parameters: client_id, client_secret, and tenant_id from your Microsoft Entra ID app registration, plus user_email for the target mailbox and folder name (e.g., "Inbox"). You can also specify num_mails to limit the number of emails retrieved.

The loader returns LlamaIndex document objects containing the subject and body text of emails from the specified folder, ready for indexing or further processing in your LlamaIndex pipeline.

This reader integrates with Microsoft Graph API for email retrieval and requires Microsoft Entra ID (formerly Azure AD) for authentication. It's built as a LlamaIndex reader, so it works within the LlamaIndex ecosystem and can feed documents into any LlamaIndex index or processing pipeline.

The app registration requires Mail.Read application permissions under Microsoft Graph with admin consent granted.

This reader is designed for organizations with Microsoft 365 infrastructure and the ability to register apps in Azure AD with appropriate Graph API permissions.

Install the package:

pip install llama-index-readers-microsoft-outlook-emails

Basic usage example:

from llama_index.readers.outlook_emails import OutlookEmailReader

loader = OutlookEmailReader(
    client_id="<Client ID of the app>",
    client_secret="<Client Secret of the app>",
    tenant_id="<Tenant ID of the Microsoft Azure Directory>",
    user_email="<User Email Address>",
    folder="Inbox",
    num_mails=10,
)

documents = loader.load_data()

Before using the reader, you must create an app registration in Microsoft Entra ID with Microsoft Graph Application Permissions for Mail.Read, and grant admin consent for these permissions.