Microsoft Outlook

Let the Dema Agent read, search, send, and manage Outlook mail through Microsoft’s hosted Mail MCP server.

Overview

Once Microsoft Outlook is connected, the Dema Agent can read your mail and send mail on your behalf without you leaving the conversation.

The agent acts only when you ask it to, and Dema asks you to confirm sensitive changes first. It signs in as whoever authorized the connection, so it sees only that person’s mailbox.

This integration covers mail only. Outlook Calendar runs on a separate Microsoft MCP server.

---

What you can ask for

Find and read mail

Ask the agent to	For example
Search your mailbox	”Find emails from Acme about the Q3 invoice.”
Read a specific message	”Open the latest email from our 3PL and tell me what they need.”
Summarize a conversation	”Summarize the thread about the Black Friday campaign.”
Triage the inbox	”List the five most recent unread emails.”

Organize your inbox

Ask the agent to	For example
Move messages	”Move everything from that supplier into the Suppliers folder.”
Work with folders	”What folders do I have, and how much unread is in each?”
Mark messages	”Mark the newsletters from last week as read.”

Compose and send

Ask the agent to	For example
Send an update	”Email this week’s margin summary to the buying team.”
Reply in a thread	”Reply to Acme confirming the new delivery date.”
Forward with context	”Forward that stock alert to ops with a one-line summary.”

---

Before you connect

Every Microsoft integration needs the same prerequisites, plus a tenant setup an admin does once per Microsoft 365 tenant. Start there, then come back:

Microsoft overview

Prerequisites, one-time tenant setup, and shared troubleshooting

---

Connect Microsoft Outlook

1. Build your MCP URL

   Outlook mail is served by mcp_MailTools. Replace {tenant_id} with your Entra tenant ID:

   MCP URL

   https://agent365.svc.cloud.microsoft/agents/tenants/{tenant_id}/servers/mcp_MailTools
   
2. Connect in Dema

   In Dema, go to Agents → Settings → Integrations, find Microsoft Outlook, and click Connect. Paste the MCP URL you built, then click Add.

3. Sign in and approve

   Sign in with a Microsoft work or school account that belongs to the same tenant as the URL, and approve the permission Dema asks for.

   You are returned to Dema with the integration marked as Active.

4. 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

Scope	What it allows
McpServers.Mail.All	Read, search, list, compose, and send Outlook mail, and manage folders, on your behalf
offline_access	Keep the connection alive so you do not have to reconnect often

Dema requests these against your tenant’s own MCP server, so the grant covers that server and not your Microsoft 365 account as a whole.

---

Troubleshooting

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 that account has no access to. Reconnect with an account that can open it.

The agent cannot see calendar events or meetings

This integration is mail only. Outlook Calendar runs on a separate Microsoft MCP server, which Dema does not support yet.

McpServers.Mail.All does not appear in Entra

An Entra admin has to register or consent the Work IQ Mail MCP server (mcp_MailTools) in your tenant before anyone can grant the permission.

Still stuck? Contact support with the error message, including the Entra AADSTS code if you have one.