Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Outlook Mac MCP

Registry nameio.github.valter-araujo/outlook-mac-mcp

How to install

What it does

MCP server for Outlook personal accounts (Hotmail/Outlook.com) via Microsoft Graph API

  • Connects –
  • Account or key No key needed
  • Category Chat & email

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness7/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score7/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer

First: which AI do you use?

Pick your app and the steps appear below.

Claude cannot connect Outlook Mac MCP yet

The maker has not listed install details in the MCP Registry yet

ChatGPT cannot connect Outlook Mac MCP yet

The maker has not listed install details in the MCP Registry yet

What you can do instead

B · Others in Chat & email that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect Outlook Mac MCP yet

The maker has not listed install details in the MCP Registry yet

Cursor cannot connect Outlook Mac MCP yet

The maker has not listed install details in the MCP Registry yet

VS Code cannot connect Outlook Mac MCP yet

The maker has not listed install details in the MCP Registry yet

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Outlook Mac MCP💬 Discussion →

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
–
Latest versioni
0.9.0
Published to registryi
Sep 18, 2026
Code last changedi
Sep 18, 2026
Maker
valter-araujo
Registry status
Active

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account valter-araujo, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 2 months ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/valter-araujo-outlook-mac-mcp.svg)](https://mcp.popnx.com/en/servers/valter-araujo-outlook-mac-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Chat & emaili

  • More stars than 0% of the other 2018 servers in this category
  • Published to the registry more recently than 28% of the other 2018 servers in this category
  • Basic checks equal to or better than 99% of the other 2018 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Outlook Mac MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 2 months ago, and the latest version (0.9.0) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code.

What can I use instead?

In the same category: emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

by anypostWidely used↓ 5.4K/wk★ 1.4KUpdated 5 days ago

Computer or cloud✓ service owner · emailmd.dev

Infobip MCP

Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.

by infobipEarly★ 36Updated 13 months ago

Runs in the cloud✓ service owner · infobip.com

kernelCAD

CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.

by w1neEarly★ 35Updated 23 days ago

Runs in the cloud✓ service owner · kernelcad.com
Compared with similar ones
This one
Outlook Mac MCP
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
Runs whereInstalls on your computerCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoYesNo
Basic checks3/35/54/44/44/44/4
LicenseMITMITAGPL-3.0Apache-2.0MITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

outlook-mac-mcp

MCP server for Microsoft Outlook, built for personal Microsoft accounts (Hotmail, Outlook.com, Live) that run on the consumer infrastructure rather than Exchange Online — and are therefore not supported by the official "Claude for Outlook" add-in nor by the Microsoft 365 connector.

Backend: Microsoft Graph API with delegated, user-consented, least-privilege scopes. Python, transport stdio, no telemetry.

Why not AppleScript

Community MCP servers for Outlook on Mac drive the app through AppleScript. That path only works with Legacy Outlook. In August 2026 Microsoft cancelled the planned AppleScript support in New Outlook, and the transition to New Outlook ends in October 2026. This project deliberately does not depend on it.

The reference environment for this project runs New Outlook (the "Legacy Outlook" toggle is present in the Outlook menu), where AppleScript automation is unavailable. This was the deciding factor.

Technical requirements

Runtime
ComponentRequirementNotes
macOS13 Ventura or laterKeychain used for token storage
Python3.12+Managed with uv; dependencies pinned in uv.lock
MCP clientAny stdio client (Claude Desktop, Claude Code)Tested against Claude Desktop
NetworkHTTPS to login.microsoftonline.com and graph.microsoft.com onlyNo other outbound calls
Microsoft account and app registration
ItemRequirement
Account typePersonal Microsoft account (Hotmail / Outlook.com / Live) or work/school
App registrationOne-time registration in Microsoft Entra ID (free; a personal account needs its own tenant, created via the Azure Portal)
Supported account types"Accounts in any organizational directory and personal Microsoft accounts"
AuthenticationDevice-code flow (MSAL, public client, no client secret)
Authorityhttps://login.microsoftonline.com/consumers
Scopes requested by defaultMail.Read, Calendars.Read, Contacts.Read, offline_access, User.Read
Scope added by OUTLOOK_MCP_ENABLE_CALENDAR_WRITE=trueCalendars.ReadWrite (see Optional: calendar write)
Admin consentNot required — every scope above is user-consentable

offline_access, openid and profile are reserved scopes: MSAL appends them to every request on its own and raises if they are passed explicitly. They are consented at the registration but never appear in the list the code asks for — that consent is what yields the refresh token behind the Keychain cache.

The app registration may list broader permissions than the server requests. The token only ever carries the scopes the running configuration asks for: the write scope is requested only behind a config flag that is off by default, and turning it on triggers a new sign-in and consent prompt.

Not required
  • Microsoft Outlook desktop app (the server talks to Graph, not to the app)
  • Exchange Online / Microsoft 365 business tenant
  • Accessibility or Automation permissions on macOS
  • Node.js, Bun, or any non-Python runtime

Validated environments

Ordered chronologically by validation date (oldest first).

VersionOSPythonMCP clientAccount typeOutlook app installedStatus
0.1.0macOS 27.0 (Golden Gate), Apple M53.14.7Claude DesktopPersonal (@hotmail.com)Outlook for Mac 16.112.4 (26090911), New Outlook, M365 Subscription — not used by the servervalidated 2026-09-14
0.2.0 (calendar write on)macOS 27.0 (Golden Gate), Apple M53.14.7Claude DesktopPersonal (@hotmail.com)as abovevalidated 2026-09-15
0.9.0 (through delete_event)macOS 27.0 (Golden Gate), Apple M53.14.7Claude DesktopPersonal (@hotmail.com)as abovevalidated 2026-09-17

A row moves to validated only after the tools it names return correct results on that environment, against a real mailbox. Contributions of new rows are welcome — please include exact versions.

Validated tools

Sorted alphabetically by tool name. One shipped tool is not in this table yet — it has unit and respx coverage but no live validation against a real mailbox:

  • search_contacts — no contact exists in the test mailbox to search for yet.
ToolValidatedWhat was checked
count_emails2026-09-15A received-time range covering one month returned an exact count.
create_event2026-09-15, 2026-09-16, 2026-09-17Created a timed event and an all-day event; Graph accepted the all-day payload with the resolved zone's name, and both came back readable. A body from the preview was written to the created event correctly. An event with no body at all also succeeded, confirming the fix for Graph defaulting an unsent body to HTML.
delete_event2026-09-17Deleted the event previewed under preview_event_deletion's token; confirmed removed from the calendar directly in Outlook.
get_email2026-09-14Text body returned with the Prefer header honoured; the malformed id nope came back as ErrorInvalidIdMalformed and was mapped to InvalidRequestError.
list_emails2026-09-15sort=oldest, limit=1 returned the folder's earliest email with an exact total; an exact-sender filter with sort=newest returned exactly one match, and Graph accepted the sender filter combined with $orderby without an InefficientFilter error.
list_folders2026-09-17Discovered 100+ custom folders correctly, including several levels of nesting, each with accurate per-folder unread/total counts. Confirmed the documented limitation live: a Microsoft-managed folder with no well-known flag (Deleted Items) appeared in custom as expected, alongside genuine user-created folders.
list_largest_emails2026-09-16Returned ranked results with real sizes from the extended property, skipped near zero.
list_todays_events2026-09-15Returned zero events, exact, on a free day.
list_unread_emails2026-09-14Reads a Hotmail inbox through Graph.
list_upcoming_events2026-09-15Returned the matching events, earliest first; confirmed both an all-day event and a timed event mapped correctly in the resolved time zone.
preview_event2026-09-15, 2026-09-16Summary and token for a timed and an all-day event; a body well under the truncation threshold showed in full, verbatim, in the preview.
preview_event_deletion2026-09-17Showed the complete event (every field, unabbreviated) with the irreversibility warning before any deletion happened.
preview_event_update2026-09-17A time change (10:00–10:30 -> 11:00–11:30) produced a diff summary showing only the changed field, old value -> new value.
search_emails2026-09-14, 2026-09-15, 2026-09-17A term matching several emails returned an exact total; scope=subject and scope=sender each returned a narrower, still-exact subset; a term trying to break out of the phrase returned empty with no 400. Passing next_page_token back as page_token returned a genuinely different second page (a different date window, no items repeated from the first), with total/total_is_exact still accurate on that page.
top_senders2026-09-15A full inbox scan hit the configured ceiling with coverage_is_complete=false; the client reported the partial coverage explicitly, as the description asks.
update_event2026-09-17Applied the previewed time change (10:00–10:30 -> 11:00–11:30) exactly; the updated event reflected only that change.

Every tool below has been validated against a real mailbox on the environment above; search_contacts has unit and respx coverage but no live validation yet (see above). Search quoting is additionally covered by a live positive-control check, see Integration tests.

Scope

  • v1 (read-only): unread emails, emails by folder (well-known or custom, by full path), search by term, read one email by id (body included), list folders, today's / upcoming events, contact search.
  • v2: create and update calendar events — behind a config flag, off by default; delete calendar events — behind a second flag, off by default even when the first one is on; mark as read — not yet built.
  • v3: send email — behind a config flag, off by default, with explicit per-call confirmation.

Tools

Read tools are always registered. The four tools marked v2, flagged register only when OUTLOOK_MCP_ENABLE_CALENDAR_WRITE=true (see Optional: calendar write). preview_event_deletion and delete_event, marked v2, flagged + calendar delete, additionally need OUTLOOK_MCP_ENABLE_CALENDAR_DELETE=true (see Optional: calendar delete). Sorted alphabetically by tool name.

ToolWhat it does
count_emailsCount emails matching the same filters as list_emails, exactly, without listing them.
create_event (v2, flagged)Create the event previewed under a token from preview_event.
delete_event (v2, flagged + calendar delete)Delete the event previewed under a token from preview_event_deletion. Irreversible.
get_emailFetch one email by id, body included.
list_emailsList emails in a folder with any combination of filters (read state, sender, date range, attachments), sorted newest or oldest, with an exact total.
list_foldersList the mailbox's well-known folders with their unread and total item counts, plus every user-created folder found by walking the mailbox tree, each identified by its full path.
list_largest_emailsList a folder's largest emails by byte size, largest first, scanning up to 10,000 matching emails per call; emails with no determinable size are counted separately in skipped.
list_todays_eventsList today's calendar events, earliest first.
list_unread_emailsList unread emails in a folder, newest first.
list_upcoming_eventsList calendar events from now through 1–30 days ahead.
preview_event (v2, flagged)Validate a new event and return a token and a summary, without creating it.
preview_event_deletion (v2, flagged + calendar delete)Fetch an existing event and return a token and a summary showing every field, unabbreviated, without deleting anything.
preview_event_update (v2, flagged)Fetch an existing event, validate the requested changes, and return a token and a diff summary (old value -> new value, changed fields only), without applying anything.
search_contactsSearch contacts by a display-name prefix or an exact email address.
search_emailsSearch a folder for a term, ranked by relevance, not by date.
top_sendersRank a folder's senders by how many emails each sent, scanning up to 10,000 matching emails per call.
update_event (v2, flagged)Apply the change previewed under a token from preview_event_update. Only the fields actually passed to the preview are changed.
Custom folders

A custom folder is any folder the user created in Outlook — not one of the five well-known folders (inbox, archive, junk email, sent items, drafts). search_emails, list_emails, count_emails, top_senders, list_largest_emails and list_unread_emails all accept one of the following as their folder argument:

  1. A well-known folder by name, matched case-insensitively — folder="inbox", folder="INBOX" and folder="Archive" all resolve the same way.
  2. `all` — every well-known folder, merged. Custom folders are never included, however many exist: folder="all".
  3. A custom folder by its full path, exactly as list_folders reports it under custom (folder names repeat across a mailbox; the full path is what disambiguates them): `fo

Only the beginning is shown; read the rest in the repo