Skip to content
MCP server

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.

How AIPoweredBot checks servers