outlook-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
outlook-mcp
An MCP server that gives an AI assistant access to your Outlook / Exchange Online mailbox and calendar, signing in the way your Mac already does: through the macOS system authentication session (Enterprise SSO / Company Portal), so it works in tenants whose Conditional Access requires a managed or compliant device.
macOS only. Talks to Exchange Web Services (EWS); no Microsoft Graph, no admin consent, no custom app registration.
What makes this different
Most Outlook MCP servers sign in with MSAL device-code or browser OAuth against their own Azure app registration. In tenants that require a managed or compliant device, or that block user consent to third-party apps, those sign-ins are refused. This server takes a different route:
System sign-in session. A small Swift helper runs
ASWebAuthenticationSession, so the sign-in goes through the same Enterprise SSO / Company Portal path as other Mac apps and carries your device identity.No app registration, no admin consent. It uses the Microsoft Office public client and EWS (
EWS.AccessAsUser.All), not Graph scopes that need consent.Unread overview without side effects.
list_mailandread_mailnever mark mail as read; onlymark_mail_readdoes.Separate draft and send tools, so drafting can be allowlisted without allowing sending.
Everything under
~/.config/outlook-mcp/, files mode 600.
The trade-offs: macOS only, EWS instead of Graph (Microsoft has announced the retirement of EWS in Exchange Online, so check your tenant's status), and the Office client ID is borrowed, so your organisation can still restrict it.
Related MCP server: outlook-mcp
Tools
Tool | What it does |
| Events in your own calendar between two ISO datetimes (recurrences expanded). |
| Free meeting slots inside working hours, optionally intersected with other people's free/busy. |
| Overview of a folder, newest first: id, sender, subject, received, read state, preview. Supports |
| Server-side mail search (Exchange query syntax) across all folders or one: |
| One message by id: headers and plain-text body. |
| All mail folders with id, path ( |
| Create a folder at the top level or under a parent folder. |
| Move messages into a folder (sorting / filing). Returns each message's new id. |
| Mark messages read or unread ( |
| Set the follow-up flag: |
| Save a message to Drafts. Sends nothing. |
| Send a message from your mailbox. Irreversible. |
Behaviour worth knowing:
list_mailandread_mailnever mark anything as read. Onlymark_mail_readchanges read state, so you can get an overview of unread mail without touching it.search_mailruns Exchange's Advanced Query Syntax on the server, newest first. Searching "all" covers every mail folder except Deleted Items and Junk Email; it queries folders a few at a time to stay under EWS's concurrent connection limit, so very large mailboxes with many folders are slower than a single-folder search.sincehas day granularity.Folder parameters (
list_mail,search_mail,create_folder,move_mail) take a well-known name (inbox,sentitems,drafts,junkemail,deleteditems,archive) or a folder id fromlist_folders. To sort mail, find it withsearch_mailorlist_mail, thenmove_mailit.move_mailgives moved messages new ids; the old ids stop working.create_folderfails if the name already exists under that parent.list_mail,search_mailandread_mailincludeflag(FlaggedorComplete) when a message is flagged.Meeting requests, responses and cancellations are listed, read and moved like ordinary mail.
find_free_slotstreats attendees whose free/busy can't be fetched as free and says so inwarnings. Free/busy of others only works if your organisation shares it. Range is limited to 62 days.send_mailanddraft_mailtaketo,cc,bcc,subject,body,isHtml. Preferdraft_mailfirst.Read-only tools are annotated
readOnlyHint, so you can allowlist them separately frommark_mail_read,flag_mail,create_folder,move_mail,draft_mailandsend_mail.
Setup
Requirements: macOS, Node 20+, Xcode command line tools (swiftc, for the sign-in helper).
npm install
npm run build # compiles helper/main.swift -> bin/auth-helper, then tsc
node dist/index.js init --tenant <tenant-guid-or-domain>
npm run login # opens the macOS sign-in sheet, onceRegister it with Claude Code (use absolute paths; the server must be started with the script as an argument):
claude mcp add outlook -s local -- "$(which node)" "$PWD/dist/index.js"Restart Claude Code (or /mcp and reconnect) afterwards.
init accepts --tenant, --client-id, --redirect-uri and --force (overwrite an existing config).
Configuration
Everything lives in ~/.config/outlook-mcp/ (directory mode 700, files mode 600):
File | Contents |
|
|
| OAuth refresh and access token. Treat as a password. |
Environment variables override the file: OUTLOOK_MCP_CONFIG, OUTLOOK_MCP_CACHE, OUTLOOK_MCP_TENANT_ID,
OUTLOOK_MCP_CLIENT_ID, OUTLOOK_MCP_REDIRECT_URI, OUTLOOK_MCP_RESOURCE, OUTLOOK_MCP_EWS_URL, OUTLOOK_MCP_EMAIL,
OUTLOOK_MCP_TIMEZONE.
Defaults: the Microsoft Office public client ID, redirect URI urn:ietf:wg:oauth:2.0:oob, resource
https://outlook.office365.com, EWS endpoint https://outlook.office365.com/EWS/Exchange.asmx. Your address is taken
from the token unless email is set. Working hours default to 09:00-17:00, Monday to Friday, in timeZone (or the
machine's zone).
How sign-in works
npm run loginbuilds the Azure AD v1 authorize URL and passes it tobin/auth-helper, a small Swift program.The helper runs an
ASWebAuthenticationSession. This is the system sign-in session, so Enterprise SSO, Company Portal and device-compliance checks apply exactly as they do for other Mac apps. Theurn:ietf:wg:oauth:2.0:oobredirect is a custom scheme the session can intercept.The authorization code is exchanged for tokens, and the refresh token is written to
token-cache.json.The server refreshes access tokens silently. If the refresh token is rejected, run
npm run loginagain.
Permissions come from the app registration of the client ID (v1 is resource-based, not scope-based). The default Office
client normally carries EWS.AccessAsUser.All, which covers reading and sending mail and calendar access. If your
tenant restricts it, calls fail with an EWS error rather than silently.
Compared with other Outlook MCP servers
As far as a README-level survey of GitHub projects shows (source code not audited), other Outlook MCP servers use Graph
with MSAL device-code or browser OAuth, drive the Outlook app via AppleScript, or reuse a browser session. Device-code
login is a separate flow from the Mac's SSO session and generally cannot satisfy "managed / compliant device"
Conditional Access policies. None found uses ASWebAuthenticationSession.
Development
npm run build:ts # tsc only
npm test # tsc + unit tests for the free-slot logicLayout: src/index.ts (tools, init/login subcommands), src/ews.ts (EWS requests), src/auth.ts (tokens),
src/config.ts, src/slots.ts (free-range maths), helper/main.swift (system auth session).
Security notes
The server can read and send mail as you. Anyone who can read
token-cache.jsonhas the same access until the session is revoked; keep~/.config/outlook-mcpout of backups and sync folders you share.send_mailis irreversible. Keep Claude Code's approval prompt on for it.Nothing secret is stored in this repository; tokens and tenant ID live only in
~/.config/outlook-mcp/.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Connect Apple iCloud and Microsoft 365 mail, calendars, contacts and tasks to AI.
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
Mail, Calendar, Messages, Notes, Contacts, Slack on your Mac for AI. Remote needs Pro or free trial.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables AI assistants to manage Microsoft Outlook email and calendar through the Microsoft Graph API, including reading, sending, searching emails, and handling calendar events.4331MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Microsoft Outlook for macOS, managing emails, calendar events, and contacts, with local AI processing via Ollama.89 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Outlook mail, calendar, and contacts via Microsoft Graph API with secure device code authentication.79 npmMIT
- AlicenseAqualityBmaintenanceEnables AI assistants to read, search, send, and manage email on macOS through programmatic access to Apple Mail.29MIT