Outlook Assistant

MCP server for Outlook email, calendar, and contacts — let your AI assistant manage your inbox directly from the conversation.

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.

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
• ✏️ Draft emails for review — create, update, and send drafts; reply and forward as drafts; preview before saving with dry-run mode
• 📅 Manage your calendar — view upcoming events, schedule meetings with attendees, decline or cancel invitations
• 📦 Export emails — save individual messages to Markdown, EML, JSON, or CSV; export full conversation threads to MBOX or HTML; bulk-export search results in one call
• 🔍 Investigate email headers — full raw header access (DKIM, SPF, DMARC, delivery chain, X-Mailer, X-Originating-IP) for phishing investigation and compliance review
• 🗂️ Organise your inbox — create nested folders (addressable by path), 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	8	search-emails (list/search/delta/conversations), read-email (content + forensic headers), send-email (with dry-run + mail tips), draft (create/update/send/delete/reply/forward), update-email (read status, flags), attachments, export, get-mail-tips
Calendar	3	list-events, create-event, manage-event (update/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) — nested folders addressable by path (Parent/Child) or ID
Rules	1	manage-rules (list/create/update/reorder/delete)
Advanced	2	access-shared-mailbox, find-meeting-rooms
Auth	1	auth (status/authenticate/about)

22 tools total — consolidated from 55 for optimal AI performance. See the Tools Reference for complete parameter details.

Export Formats

Format support varies by target:

Format	Extension	target=message (single)	target=messages (batch)	target=conversation (thread)
mime / eml	.eml	✅	–	✅
mbox	.mbox	–	–	✅
markdown	.md	✅	✅	✅
json	.json	✅	✅	✅
html	.html	–	–	✅
csv	.csv	✅	✅	✅

Export individual emails, search results, or entire conversation threads — use target=messages with a search query (or the query shortcut) 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 — progressive fallback; subject, from, to filters are more direct	Full $search support
Categories	Full support	Full support
Mailbox settings	Full support	Full support
Focused Inbox	API works (overrides stored) but mail routing not affected	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 $search API 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