Outlook Mac MCP
MCP server giving AI clients read and calendar access to personal Outlook.com and Hotmail
- Pricing
- Open source
- Platforms
- macOS, CLI, self-hosted
- Version
- 0.9.0
- Listing updated
- today
Similar MCP servers
About Outlook Mac MCP
Outlook Mac MCP is an open-source MCP server for communication. It is available on macOS, CLI, self-hosted and API.
The README says this server connects AI clients to personal Microsoft accounts such as Hotmail, Outlook.com and Live through the Microsoft Graph API, targeting mailboxes that the Outlook add-in and Microsoft 365 connector do not cover. It is written in Python, runs over stdio, and stores tokens in the macOS Keychain.
The default configuration is read-only: it searches and lists mail, counts and ranks senders, inspects folders including nested custom ones, and reads today's and upcoming calendar events. Calendar creation and updates sit behind an off-by-default flag, and deletion requires a second flag on top of that. Every write is a preview-then-apply pair using single-use tokens.
The project is aimed at users on macOS running New Outlook who want an assistant to work with a personal mailbox. The README notes the server was validated with Claude Desktop on macOS 27 against a Hotmail account, and that its sign-in is a one-time out-of-band step.
Tools this server provides (17)
Taken from the project documentation; the running server may differ.
- count_emails
- Count emails matching filters exactly, without listing them.
- create_event
- Create the event previewed under a token (calendar write flag).
- delete_event
- Delete the event previewed under a token (calendar delete flag). Irreversible.
- get_email
- Fetch one email by id, body included.
- list_emails
- List emails in a folder with filters, sorted, with an exact total.
- list_folders
- List well-known folders with counts and user-created folders by full path.
- list_largest_emails
- List a folder's largest emails by byte size.
- list_todays_events
- List today's calendar events, earliest first.
- list_unread_emails
- List unread emails in a folder, newest first.
- list_upcoming_events
- List calendar events from now through 1 to 30 days ahead.
- preview_event
- Validate a new event and return a token without creating it (calendar write flag).
- preview_event_deletion
- Show every field of an event and return a token without deleting (delete flag).
- preview_event_update
- Validate requested event changes and return a diff token (calendar write flag).
- search_contacts
- Search contacts by display-name prefix or exact email address.
- search_emails
- Search a folder for a term, ranked by relevance.
- top_senders
- Rank a folder's senders by how many emails each sent.
- update_event
- Apply the change previewed under a token (calendar write flag).
What it does
- Read-only mail access
- Lists, searches, counts and reads emails from well-known and custom folders by default.
- Calendar reading
- Shows today's and upcoming calendar events in a configurable time zone.
- Gated calendar writes
- Create and update events only when an explicit environment flag is set, using preview and confirm steps.
- Keychain token storage
- OAuth tokens are kept in the macOS Keychain rather than in files or environment variables.
- Custom folder paths
- Addresses nested custom folders by their full path, with typo rejection for well-known names.
Good for
- Searching a Hotmail or Outlook.com inbox from an AI assistant
- Ranking which senders fill a mailbox folder
- Finding the largest emails to free up storage
- Checking today's or the coming week's calendar from a chat client
- Creating or updating calendar events after reviewing a preview
Pricing
Open source
Free, MIT-licensed open source; self-hosted on the user's Mac.
Outlook Mac MCP FAQ
Does it work with work or Microsoft 365 accounts?
The README says the app registration supports work or school accounts as well as personal Microsoft accounts, but its stated focus is personal mailboxes that the official Outlook add-in and Microsoft 365 connector do not support.
Does it need the Outlook desktop app installed?
No. The README says the server talks to Microsoft Graph rather than the Outlook app, so the desktop app is not required.
Can it send email?
Not in the current build. The README lists sending email as a planned v3 feature behind an off-by-default flag.
Is calendar deletion reversible?
No. The README states that delete_event cannot be undone by the server, which is why it needs a separate flag and a preview step.
Is Outlook Mac MCP free?
Yes. Outlook Mac MCP is open source, so you can use and self-host it for free.
What are the best alternatives to Outlook Mac MCP?
The closest alternatives to Outlook Mac MCP are Outlook Email, Mac Mail MCP, Outlook Calendar, mcp-mail and icloud-mcp.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.