# Outlook Mac MCP

> Outlook Mac MCP is an open-source MCP server for communication. MCP server giving AI clients read and calendar access to personal Outlook.com and Hotmail. It is available on macOS, CLI, self-hosted and API.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI, self-hosted, API
- **Repository:** https://github.com/valter-araujo/outlook-mac-mcp
- **MCP Registry name:** io.github.valter-araujo/outlook-mac-mcp
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Tools

- `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).

## 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.

## Alternatives

- [Outlook Email](https://ai-powered.com/mcp/outlook-email-2): Outlook Email is an open-source MCP server for communication.
- [Mac Mail MCP](https://ai-powered.com/mcp/mac-mail-mcp): Mac Mail MCP is an open-source MCP server for communication.
- [Outlook Calendar](https://ai-powered.com/mcp/outlook-calendar-3): Outlook Calendar is an open-source MCP server for communication.
- [mcp-mail](https://ai-powered.com/mcp/mcp-mail): mcp-mail is an open-source MCP server for communication.
- [icloud-mcp](https://ai-powered.com/mcp/icloud-mcp-3): icloud-mcp is an open-source MCP server for productivity.
- [Thunderbird MCP](https://ai-powered.com/mcp/thunderbird-mcp): Thunderbird MCP is an open-source MCP server for communication.
- [Claws Mail MCP Plugin](https://ai-powered.com/mcp/claws-mail-mcp-plugin): Claws Mail MCP Plugin is an open-source MCP server for communication.
- [macOS Apps](https://ai-powered.com/mcp/macos-apps): macOS Apps is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/outlook-mac-mcp
