> ## Documentation Index > Fetch the complete documentation index at: https://docs.dema.ai/llms.txt > Use this file to discover all available pages before exploring further. # Microsoft Outlook > Let the Dema Agent search, read, send, and organize Outlook mail in any Microsoft 365 work mailbox through Microsoft Graph. ## Overview Once Microsoft Outlook is connected, the Dema Agent can read your mail, send mail on your behalf, and keep your inbox organized without you leaving the conversation. This integration talks to your mailbox through Microsoft Graph. It works with any Microsoft 365 work mailbox. You don't need a Microsoft 365 Copilot licence, Agent 365 tenant setup, a tenant ID, or an MCP URL. The agent acts only when you ask it to. It signs in as whoever authorized the connection, so it sees only that person's mailbox. > [!NOTE] > > The Microsoft Outlook integration is in **preview**. Tools can change without notice. Your workspace might need preview integrations enabled before it shows up. > [!TIP] > > Already use Microsoft Agent 365? [Microsoft Outlook (MCP)](https://docs.dema.ai/guides/agent/integrations/microsoft-outlook.md) connects through Microsoft's hosted Mail MCP server instead. Both integrations cover mail only. *** ## What you can ask for > [accordion] Find and read mail > > | Ask the agent to | For example | > | - | - | > | Search your mailbox | *"Find emails from Acme about the Q3 invoice."* | > | List unread mail | *"List the ten most recent unread emails in my inbox."* | > | Read a specific message | *"Open the latest email from our 3PL and tell me what they need."* | > | Download an attachment | *"Download the CSV attached to the supplier's price update and summarize it."* | > [accordion] Organize your inbox > > | Ask the agent to | For example | > | - | - | > | List folders | *"What folders do I have, and how much unread is in each?"* | > | Mark messages read or unread | *"Mark the newsletters from last week as read."* | > | Flag messages or set categories | *"Flag the Acme invoice email and categorize it as Finance."* | > | Move messages | *"Move everything from that supplier into the Suppliers folder."* | > | Delete messages | *"Delete the duplicate stock alert."* | > [accordion] Compose and send > > | Ask the agent to | For example | > | - | - | > | Send an email | *"Email this week's margin summary to the buying team."* | > | Save a draft | *"Draft a reply to the agency about the campaign brief, but don't send it."* | > | Reply or reply all | *"Reply all to Acme confirming the new delivery date."* | > | Forward with context | *"Forward that stock alert to ops with a one-line summary."* | Deleting a message moves it to **Deleted Items**. The agent does not permanently delete mail. *** ## Prerequisites * A Microsoft 365 **work or school** account with an Outlook mailbox. * If your organization does not let users approve app permissions themselves, a Microsoft Entra admin may need to approve Dema for your tenant. *** ## Connect Microsoft Outlook **1. Connect in Dema** In Dema, go to **Agents → Settings → Integrations**, find **Microsoft Outlook**, and click **Connect**. **2. Sign in and approve** Sign in with your Microsoft work or school account and approve the permissions Dema requests. > [!TIP] > > You are returned to Dema with the integration marked as Active. **3. Check it works** Ask the agent something only Outlook can answer, for example: *"List the five most recent unread emails in my inbox."* If it comes back with real subject lines, the connection works. > [!TIP] > > Authorize with a dedicated agent mailbox instead of your personal inbox, and forward only what the agent needs. See [Best practices](https://docs.dema.ai/guides/agent/integrations/overview.md#best-practices) in the integrations overview. *** ## Scopes Dema requests | Scope | What it allows | | - | - | | `Mail.ReadWrite` | Read, search, draft, move, and update messages and folders in your mailbox | | `Mail.Send` | Send, reply to, and forward mail as you | | `offline_access` | Keep the connection alive so you do not have to reconnect often | These are delegated permissions. Dema can only do what the signed-in user can do in their own mailbox. *** ## Limits * **Attachments:** Keep the total size of attachments under about 2 MB per message. Larger messages fail to send. Ask the agent to share a link instead, or split files across several emails. * **Mail only:** The integration does not cover Outlook Calendar or contacts. *** ## Troubleshooting > [accordion] Microsoft Outlook does not appear in the integrations list > > The integration is in preview, so your workspace might need preview integrations enabled before it shows up. Contact [support](mailto:info@dema.ai) if you want access. > [accordion] Sign-in says approval is required by an administrator > > Your tenant does not allow users to approve app permissions themselves. Ask a Microsoft Entra admin to approve Dema for your organization, then connect again. > [accordion] The agent cannot find an email you can see > > The agent searches only the mailbox of the account that authorized the connection. It cannot read someone else's mailbox or a shared mailbox. Reconnect with the account that owns the mailbox. > [accordion] Sending fails because the message is too large > > The attachments exceed the roughly 2 MB limit. Remove or shrink attachments and try again. Still stuck? Contact [support](mailto:info@dema.ai) with the error message, including the Entra `AADSTS` code if you have one. *** ## Additional resources * [Microsoft Graph Mail API overview](https://learn.microsoft.com/graph/outlook-mail-concept-overview) * [Microsoft Graph permissions reference](https://learn.microsoft.com/graph/permissions-reference) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.