1
Add it to Claude Code
claude mcp add -e "AZURE_CLIENT_ID=${AZURE_CLIENT_ID}" -e "AZURE_TENANT_ID=${AZURE_TENANT_ID}" -e "AZURE_CLIENT_SECRET=${AZURE_CLIENT_SECRET}" outlook-mcp -- npx -y @littlebearapps/outlook-assistantRequired:
AZURE_CLIENT_IDAZURE_TENANT_IDAZURE_CLIENT_SECRET2
Make your agent remember this setup
outlook-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Search and read emails with conversation grouping and forensic header analysis
- Send emails with safety controls like dry-run previews and recipient allowlists
- Manage calendar events including scheduling, declining, and canceling invitations
- Perform delta sync to track new, modified, or deleted emails since the last check
- Organize inbox via folder creation, category color-coding, and rule management
Tools 3
search-emailsList, search, or perform delta sync on emails and conversations.read-emailRead full email content and forensic headers.send-emailDraft and send emails with safety controls.Environment Variables
AZURE_CLIENT_IDrequiredAzure AD Application Client IDAZURE_TENANT_IDrequiredAzure AD Tenant IDAZURE_CLIENT_SECRETrequiredAzure AD Application Client SecretTry it
→Search my inbox for emails from my manager received in the last 3 days and summarize them.
→Draft a reply to the latest email from the project team confirming I will attend the meeting.
→Check my calendar for tomorrow and list all meetings scheduled before noon.
→Find any emails in my inbox that might be phishing by checking the DKIM and SPF headers.
→Create a new folder named 'Project Alpha' and move all emails with that subject into it.
Original README from littlebearapps/outlook-assistant
<h1 align="center">Outlook Assistant</h1>
<strong>MCP server for Outlook email, calendar, and contacts — let your AI assistant manage your inbox directly from the conversation.</strong>
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.
<a href="https://github.com/littlebearapps/outlook-assistant/blob/main/docs/demo/outlook-assistant-demo.mp4"> </a><sub>Search inbox → read & summarise → draft a reply — all from the conversation</sub>
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 |
|---|---|---|
| 7 | search-emails (list/search/delta/conversations), read-email (content + forensic headers), send-email |