Microsoft Outlook
The Microsoft Outlook connection uses Microsoft OAuth and Graph to work with the connected user's mailbox. It lets agents read inbox context, create drafts, and send mail from the connected account, with confirmation on writes.
When to Use It
Use it when an agent needs to read recent inbox context, inspect a specific message, create a draft, or send an approved email through a governed Microsoft account.
Setup
- In Connections, click Add Integration and choose Microsoft Outlook from the Microsoft provider group.
- Sign in with the Microsoft account that should read, draft, or send messages. The tool uses Microsoft Graph through OAuth.
- Decide private or shared access. Use private access for personal mailboxes, and shared access only for team-owned mailboxes or approved operational accounts.
- Require review for writes. Sending email and creating drafts are data-modifying functions, so keep confirmation enabled for production and customer-facing workflows.
What the Tool Can Do
- List inbox messages. Returns the most recent messages from the inbox, with an optional setting to include junk and deleted items.
- Get message details. Retrieves the full content of a specific email by Microsoft Graph message ID.
- Create an email draft. Creates a draft with recipient, subject, and body. Use this for review-first workflows before anything is sent.
- Send email. Sends an email from the connected Outlook account and saves it to sent items. Treat this as a write action.
Security and Confirmation
Sending email and creating drafts modify the connected mailbox, so keep confirmation enabled for customer-facing workflows. Before you enable sending, confirm that:
- The connected account is the mailbox that should appear as sender.
- Shared access is limited to team-owned or approved operational mailboxes.
- Send email requires human approval for customer-facing workflows.
- Draft creation is preferred when the user should review wording first.
- The agent prompt states tone, audience, recipient, and source context.
- Tool Runs are reviewed when a send, draft, or inbox read behaves unexpectedly.
Example Usage
Find the latest email from acme@example.com, summarize the request,
and draft a reply. Do not send it until I approve the subject and body.
Create a polite follow-up draft for this customer. Use the attached context,
keep it under 120 words, and show me the draft before saving it.
List my last 10 inbox messages and identify anything that looks like a
renewal, support escalation, or meeting follow-up.
Technical Notes
| Area | Details |
|---|---|
| Tool | MicrosoftOutlook in Siesta.AI.Tools.Outlook |
| Auth | Microsoft OAuth token resolved through the common OAuth service |
| API | Microsoft Graph Me mailbox endpoints |
| Read functions | List recent inbox messages, get a specific message by ID |
| Write functions | Create draft, send email with SaveToSentItems = true |
| Body handling | Plain text input is converted to HTML before Graph sends or saves the message |
Common Problems
| Symptom | Likely cause | Fix |
|---|---|---|
| Agent cannot read inbox | OAuth token expired or mailbox permission changed | Reconnect Microsoft Outlook from the connection detail. |
| Email sent from wrong account | The wrong Microsoft account was authorized | Recreate or reconnect the connection with the intended mailbox. |
| Send is blocked | Function policy requires approval or disables sending | Approve the pending action or ask an admin to review governance. |
| Message details fail | The message ID is stale or belongs to a mailbox the connection cannot access | Ask the agent to list current inbox messages again and retry with the returned ID. |