Skip to main content

​
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.
The Microsoft Outlook integration is in preview. Tools can change without notice. Your workspace might need preview integrations enabled before it shows up.
Already use Microsoft Agent 365? Microsoft Outlook (MCP) connects through Microsoft’s hosted Mail MCP server instead. Both integrations cover mail only.

​
What you can ask for

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.
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.
Authorize with a dedicated agent mailbox instead of your personal inbox, and forward only what the agent needs. See Best practices in the integrations overview.

​
Scopes Dema requests

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

The integration is in preview, so your workspace might need preview integrations enabled before it shows up. Contact support if you want access.
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.
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.
The attachments exceed the roughly 2 MB limit. Remove or shrink attachments and try again.
Still stuck? Contact support with the error message, including the Entra AADSTS code if you have one.

​
Additional resources