> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.airweave.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airweave.ai/_mcp/server.
# Outlook Mail
> Outlook Mail integration with Airweave
{/* AUTO-GENERATED CONTENT START */}
Outlook Mail
This connector enables AI agents and RAG systems to retrieve context from Outlook Mail through Airweave's unified search layer.
## Configuration
Outlook Mail source connector integrates with the Microsoft Graph API to extract email data.
Synchronizes data from Outlook mailboxes.
It provides comprehensive access to mail folders, messages, and
attachments with hierarchical folder organization and content processing capabilities.
#### [View Source Code](https://github.com/airweave-ai/airweave/tree/main/backend/airweave/platform/sources/outlook_mail.py)
Explore the Outlook Mail connector implementation
### Authentication
This connector uses **OAuth 2.0 authentication**. You can connect through the Airweave UI or API using the OAuth flow.
**Supported authentication methods:**
* OAuth Browser Flow (recommended for UI)
* OAuth Token (for programmatic access)
* Auth Provider (enterprise SSO)
### Configuration Options
This connector does not have any additional configuration options.
## Data Models
The following data models are available for this connector:
#### OutlookMailFolderEntity
Schema for an Outlook mail folder.
See:
[https://learn.microsoft.com/en-us/graph/api/resources/mailfolder?view=graph-rest-1.0](https://learn.microsoft.com/en-us/graph/api/resources/mailfolder?view=graph-rest-1.0)
| Field | Type | Description |
| -------------------- | -------------- | ------------------------------------------------------------- |
| id | str | Mail folder ID from Microsoft Graph. |
| display\_name | str | Display name of the mail folder (e.g., 'Inbox'). |
| parent\_folder\_id | Optional\[str] | ID of the parent mail folder, if any. |
| child\_folder\_count | Optional\[int] | Number of child mail folders under this folder. |
| total\_item\_count | Optional\[int] | Total number of items (messages) in this folder. |
| unread\_item\_count | Optional\[int] | Number of unread items in this folder. |
| well\_known\_name | Optional\[str] | Well-known name of this folder if applicable (e.g., 'inbox'). |
| web\_url\_override | Optional\[str] | URL to open this folder in Outlook on the web. |
#### OutlookMessageEntity
Schema for Outlook message entities.
Reference: [https://learn.microsoft.com/en-us/graph/api/resources/message?view=graph-rest-1.0](https://learn.microsoft.com/en-us/graph/api/resources/message?view=graph-rest-1.0)
| Field | Type | Description |
| --------------------- | ------------------- | ------------------------------------------ |
| id | str | Message ID from Microsoft Graph. |
| folder\_name | str | Name of the folder containing this message |
| subject | str | Subject line of the message. |
| sender | Optional\[str] | Email address of the sender |
| to\_recipients | List\[str] | Recipients of the message |
| cc\_recipients | List\[str] | CC recipients |
| sent\_date | Optional\[datetime] | Date the message was sent |
| received\_date | Optional\[datetime] | Date the message was received |
| body\_preview | Optional\[str] | Brief snippet of the message content |
| is\_read | bool | Whether the message has been read |
| is\_draft | bool | Whether the message is a draft |
| importance | Optional\[str] | Importance level (Low, Normal, High) |
| has\_attachments | bool | Whether the message has attachments |
| internet\_message\_id | Optional\[str] | Internet message ID |
| web\_url\_override | Optional\[str] | Link to the message in Outlook on the web. |
#### OutlookAttachmentEntity
Schema for Outlook attachment entities.
Reference: [https://learn.microsoft.com/en-us/graph/api/resources/fileattachment?view=graph-rest-1.0](https://learn.microsoft.com/en-us/graph/api/resources/fileattachment?view=graph-rest-1.0)
| Field | Type | Description |
| ----------------- | --------------- | ------------------------------------------------ |
| composite\_id | str | Composite attachment ID (message + attachment). |
| name | str | Attachment filename. |
| message\_id | str | ID of the message this attachment belongs to |
| attachment\_id | str | Outlook's attachment ID |
| content\_type | Optional\[str] | Content type of the attachment |
| is\_inline | bool | Whether this is an inline attachment |
| content\_id | Optional\[str] | Content ID for inline attachments |
| metadata | Dict\[str, Any] | Additional metadata about the attachment |
| message\_web\_url | Optional\[str] | URL to the parent message in Outlook on the web. |
#### OutlookMessageDeletionEntity
Deletion signal for an Outlook message.
Emitted when the Graph delta API reports a message was removed.
The `entity_id` (derived from `message_id`) matches the original message's id
so downstream deletion can target the correct parent/children.
| Field | Type | Description |
| ----------- | ---- | ----------------------------- |
| message\_id | str | ID of the deleted message |
| label | str | Human-readable deletion label |
#### OutlookMailFolderDeletionEntity
Deletion signal for an Outlook mail folder.
Emitted when the Graph delta API reports a folder was removed.
The `entity_id` (derived from `folder_id`) matches the original folder's id.
| Field | Type | Description |
| ---------- | ---- | ----------------------------- |
| folder\_id | str | ID of the deleted folder |
| label | str | Human-readable deletion label |
{/* AUTO-GENERATED CONTENT END */}