Outlook Assistant
MCP server for Outlook email, calendar, and contacts — let your AI assistant manage your inbox directly from the conversation.
Install / Use
/learn @littlebearapps/Outlook AssistantQuality Score
Category
Development & EngineeringSupported Platforms
README
Outlook Assistant connects AI assistants to your Microsoft Outlook account through the Model Context Protocol. Ask your AI assistant to search your inbox, send emails, schedule meetings, manage contacts, and configure mailbox settings — without leaving the conversation. Works with Claude, Cursor, Windsurf, and any MCP-compatible client.
Works with personal Outlook.com and work/school Microsoft 365 accounts.
<div align="center"> <br /> <a href="docs/demo/outlook-assistant-demo.mp4"> <img src="docs/demo/outlook-assistant-demo.gif" alt="Outlook Assistant Demo — searching emails, reading, and drafting a reply" width="720" style="border-radius: 12px; box-shadow: 0 8px 32px rgba(0,0,0,0.12);" /> </a> <br /> <sub>Search inbox → read & summarise → draft a reply — all from the conversation</sub> <br /><br /> </div>What you can do
- 📨 Search and read emails — find messages by sender, subject, date, or keywords; read full threads with conversation grouping; batch flag, move, export, or categorise multiple emails at once
- 🛡️ Send emails with safety controls — dry-run preview, pre-send mail tips (out-of-office, mailbox full, delivery restrictions), session rate limiting, and recipient allowlist to prevent mistakes
- 📅 Manage your calendar — view upcoming events, schedule meetings with attendees, decline or cancel invitations
- 📦 Export emails — save to Markdown, EML, MBOX, JSON, or HTML for archiving, analysis, or migration; export search results or entire threads in one call
- 🔍 Investigate email headers — check DKIM, SPF, and DMARC authentication; trace delivery chains; analyse spam scores — useful for phishing investigation and compliance
- 🗂️ Organise your inbox — create folders, set up inbox rules, colour-code with categories, manage Focused Inbox — all work together for complete inbox automation
- 🔄 Track inbox changes — delta sync detects new, modified, and deleted emails since your last check, with tokens for incremental polling
- 👥 Manage contacts — search your contact book and organisational directory, create and update contact records
- ⚙️ Configure settings — set out-of-office auto-replies, working hours, and time zone
- 📬 Access shared mailboxes — read team inboxes and service accounts (Microsoft 365)
- 🏢 Find meeting rooms — search by building, floor, capacity, AV equipment, and wheelchair accessibility (Microsoft 365)
Why Outlook Assistant?
| Without Outlook Assistant | With Outlook Assistant | |---------------------|------------------| | Switch between your AI tool and Outlook to manage email | Read, search, send, and export emails directly from your AI assistant | | Manually search and export email threads | Full email tools including search, threading, and bulk export | | Context-switch for calendar and contacts | Manage calendar events, contacts, and settings in one place | | Copy-paste email content into conversations | Your AI assistant reads your emails natively with full context | | No programmatic access to mailbox rules or categories | Create inbox rules, manage categories, configure auto-replies | | Manually check each email for phishing red flags | Forensic header analysis — DKIM, SPF, DMARC, spam scores, and delivery chain in one call | | Poll your inbox to check for new mail | Delta sync returns only changes since your last check, with tokens for continuous polling |
Features
| Module | Tools | What You Can Do |
|--------|------:|-----------------|
| Email | 7 | search-emails (list/search/delta/conversations), read-email (content + forensic headers), send-email (with dry-run + mail tips), update-email (read status, flags), attachments, export, get-mail-tips |
| Calendar | 3 | list-events, create-event, manage-event (decline/cancel/delete) |
| Contacts | 2 | manage-contact (list/search/get/create/update/delete), search-people |
| Categories | 3 | manage-category (CRUD), apply-category, manage-focused-inbox |
| Settings | 1 | mailbox-settings (get/set auto-replies/set working hours) |
| Folder | 1 | folders (list/create/move/stats/delete) |
| Rules | 1 | manage-rules (list/create/reorder/delete) |
| Advanced | 2 | access-shared-mailbox, find-meeting-rooms |
| Auth | 1 | auth (status/authenticate/about) |
21 tools total — consolidated from 55 for optimal AI performance. See the Tools Reference for complete parameter details.
Export Formats
| Format | Extension | When to Use It |
|--------|-----------|----------------|
| mime / eml | .eml | Legal holds, forensic preservation, importing into other mail clients |
| mbox | .mbox | Archiving entire conversation threads, migrating between systems |
| markdown | .md | Pasting into documents, feeding into AI workflows |
| json | .json | Data analysis, pipeline processing, compliance reporting |
| html | .html | Visual archival with formatting intact |
| csv | .csv | Spreadsheet import, bulk metadata analysis, compliance audits |
Export individual emails, search results, or entire conversation threads — use target=messages with a search query to batch-export without manually collecting IDs.
Account Compatibility
Outlook Assistant works with both personal and work/school Microsoft accounts, but some features behave differently:
| Feature | Personal (Outlook.com) | Work/School (Microsoft 365) |
|---------|----------------------|---------------------------|
| Email read, send, search | Full support | Full support |
| Calendar events | Full support | Full support |
| Contacts CRUD | Full support | Full support |
| Inbox rules | Full support | Full support |
| Folders | Full support | Full support |
| Free-text query search | Limited — use subject, from, to filters instead | Full KQL support |
| Categories | Full support | Full support |
| Mailbox settings | Full support | Full support |
| Focused Inbox | Not available | Full support |
| Shared mailboxes | Not available | Requires Mail.Read.Shared |
| Meeting room search | Not available | Requires Place.Read.All + admin consent |
Note: On personal accounts, Microsoft's
$searchAPI has limited support for free-text queries. Outlook Assistant handles this automatically with progressive search — if your query returns no results, it falls back through OData filters, boolean filters, and recent message listing to find your emails. For the most direct results on personal accounts, use the structured filter parameters (from,subject,to,receivedAfter).
What Makes This Different
- Progressive search — on accounts where Microsoft's
$searchAPI is limited, Outlook Assistant automatically falls back through up to 4 search strategies to find your emails. Most Graph API wrappers fail silently; this one adapts. - Email forensics — full header analysis (DKIM, SPF, DMARC, delivery chain, spam scores) built in as a first-class feature — useful for phishing investigation, compliance, and security review.
- Delta sync — incremental inbox monitoring returns only what changed since your last check, with tokens for continuous polling. Designed for agent workflows that need to watch a mailbox.
- Batch operations — flag, move, export, or categorise multiple emails in a single call. Search-driven export lets you batch-export results without collecting IDs manually.
- Pre-send intelligence — check recipients for out-of-office, full mailbox, delivery restrictions, and moderation status before sending — no other Outlook MCP server offers this.
- Compound automation — rules, categories, folders, and Focused Inbox work together. Set up complete inbox management through your AI assistant in one conversation.
Safety & Token Efficiency
Outlook Assistant is designed with safety-first principles for AI-driven email access:
Destructive action safeguards — Every tool carries MCP annotations (readOnlyHint, destructiveHint, idempotentHint) so AI clients can auto-approve safe reads and prompt for confirmation on destructive operations like sending email or deleting events.
Send-email protections — The send-email tool includes:
- Pre-send mail tips (
checkRecipients: true) — check recipients for out-of-office, mailbox full, delivery restrictions before sending - Dry-run mode (
dryRun: true) — preview composed emails without sending - Session rate limiting — configurable via
OUTLOOK_MAX_EMAILS_PER_SESSION(de
Related Skills
imsg
332.3kiMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.
node-connect
332.3kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
oracle
332.3kBest practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
lobster
332.3kLobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (s
