Inbox Zero
Search Gmail and Outlook, save drafts, manage email rules, and view email stats.
클라우드에서 실행
Outlook Mac MCP
What it does
MCP server for Outlook personal accounts (Hotmail/Outlook.com) via Microsoft Graph API
- Connects –
- Account or key No key needed
- Category 채팅 및 이메일
설치
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
검사 3/3 통과 · 내 컴퓨터에서 실행돼요
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude는 아직 Outlook Mac MCP에 연결할 수 없어요
제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요
ChatGPT는 아직 Outlook Mac MCP에 연결할 수 없어요
제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요
대신 이렇게 할 수 있어요
B · 채팅 및 이메일에서 ChatGPT에 연결되는 다른 서버
같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요
- Inbox Zero✓ ChatGPT
- draw.io✓ ChatGPT
- TradingMCP✓ ChatGPT
Claude Code는 아직 Outlook Mac MCP에 연결할 수 없어요
제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요
Cursor는 아직 Outlook Mac MCP에 연결할 수 없어요
제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요
VS Code는 아직 Outlook Mac MCP에 연결할 수 없어요
제작자가 아직 MCP 레지스트리에 설치 방법을 올리지 않았어요
한눈에 보기
할 수 있는 일
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
기본 점검i
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 13일 점검
- ✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 valter-araujo 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
- ✓ 통과
계속 관리되고 있음
코드 마지막 변경: 2개월 전
- ✓ 통과
라이선스 있음
MIT 사용
- – 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
- – 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
- … 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
토론
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
사용자 리뷰
아직 리뷰가 없어요
채팅 및 이메일 카테고리의 다른 서버와 비교i
- 이 카테고리의 다른 서버 1994개 중 0%보다 스타가 많아요
- 이 카테고리의 다른 서버 1994개 중 30%보다 최근에 레지스트리에 공개됐어요
- 기본 점검 결과가 이 카테고리의 다른 서버 1994개 중 100%와 같거나 더 좋아요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
자주 묻는 질문
Outlook Mac MCP, 안전한가요?
해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
어떤 키나 코드가 필요한가요?
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
아직 관리되고 있나요?
GitHub 저장소는 마지막으로 2개월 전 변경됐고, 최신 버전(0.9.0)은 2개월 전 레지스트리에 올라왔어요.
어떤 앱에서 쓸 수 있나요?
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요.
대신 쓸 수 있는 건 뭐가 있나요?
같은 카테고리에는: Inbox Zero, draw.io, TradingMCP
같은 카테고리의 다른 것
같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
draw.io
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
클라우드에서 실행✓ 서비스 회사 · draw.io
TradingMCP
Market analysis for AI assistants: screeners, multi-timeframe analysis, backtests, in-chat charts.
클라우드에서 실행
제작자의 README
README 열기
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
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
| Component | Requirement | Notes |
|---|---|---|
| macOS | 13 Ventura or later | Keychain used for token storage |
| Python | 3.12+ | Managed with uv; dependencies pinned in uv.lock |
| MCP client | Any stdio client (Claude Desktop, Claude Code) | Tested against Claude Desktop |
| Network | HTTPS to login.microsoftonline.com and graph.microsoft.com only | No other outbound calls |
Microsoft account and app registration
| Item | Requirement |
|---|---|
| Account type | Personal Microsoft account (Hotmail / Outlook.com / Live) or work/school |
| App registration | One-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" |
| Authentication | Device-code flow (MSAL, public client, no client secret) |
| Authority | https://login.microsoftonline.com/consumers |
| Scopes requested by default | Mail.Read, Calendars.Read, Contacts.Read, offline_access, User.Read |
Scope added by OUTLOOK_MCP_ENABLE_CALENDAR_WRITE=true | Calendars.ReadWrite (see Optional: calendar write) |
| Admin consent | Not 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).
| Version | OS | Python | MCP client | Account type | Outlook app installed | Status |
|---|---|---|---|---|---|---|
| 0.1.0 | macOS 27.0 (Golden Gate), Apple M5 | 3.14.7 | Claude Desktop | Personal (@hotmail.com) | Outlook for Mac 16.112.4 (26090911), New Outlook, M365 Subscription — not used by the server | validated 2026-09-14 |
| 0.2.0 (calendar write on) | macOS 27.0 (Golden Gate), Apple M5 | 3.14.7 | Claude Desktop | Personal (@hotmail.com) | as above | validated 2026-09-15 |
| 0.9.0 (through delete_event) | macOS 27.0 (Golden Gate), Apple M5 | 3.14.7 | Claude Desktop | Personal (@hotmail.com) | as above | validated 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.
| Tool | Validated | What was checked |
|---|---|---|
count_emails | 2026-09-15 | A received-time range covering one month returned an exact count. |
create_event | 2026-09-15, 2026-09-16, 2026-09-17 | Created 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_event | 2026-09-17 | Deleted the event previewed under preview_event_deletion's token; confirmed removed from the calendar directly in Outlook. |
get_email | 2026-09-14 | Text body returned with the Prefer header honoured; the malformed id nope came back as ErrorInvalidIdMalformed and was mapped to InvalidRequestError. |
list_emails | 2026-09-15 | sort=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_folders | 2026-09-17 | Discovered 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_emails | 2026-09-16 | Returned ranked results with real sizes from the extended property, skipped near zero. |
list_todays_events | 2026-09-15 | Returned zero events, exact, on a free day. |
list_unread_emails | 2026-09-14 | Reads a Hotmail inbox through Graph. |
list_upcoming_events | 2026-09-15 | Returned the matching events, earliest first; confirmed both an all-day event and a timed event mapped correctly in the resolved time zone. |
preview_event | 2026-09-15, 2026-09-16 | Summary 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_deletion | 2026-09-17 | Showed the complete event (every field, unabbreviated) with the irreversibility warning before any deletion happened. |
preview_event_update | 2026-09-17 | A time change (10:00–10:30 -> 11:00–11:30) produced a diff summary showing only the changed field, old value -> new value. |
search_emails | 2026-09-14, 2026-09-15, 2026-09-17 | A 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_senders | 2026-09-15 | A full inbox scan hit the configured ceiling with coverage_is_complete=false; the client reported the partial coverage explicitly, as the description asks. |
update_event | 2026-09-17 | Applied 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.
| Tool | What it does |
|---|---|
count_emails | Count 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_email | Fetch one email by id, body included. |
list_emails | List emails in a folder with any combination of filters (read state, sender, date range, attachments), sorted newest or oldest, with an exact total. |
list_folders | List 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_emails | List 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_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–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_contacts | Search contacts by a display-name prefix or an exact email address. |
search_emails | Search a folder for a term, ranked by relevance, not by date. |
top_senders | Rank 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:
- A well-known folder by name, matched case-insensitively —
folder="inbox",folder="INBOX"andfolder="Archive"all resolve the same way. - `all` — every well-known folder, merged. Custom folders are never included, however many exist:
folder="all". - A custom folder by its full path, exactly as
list_foldersreports it undercustom(folder names repeat across a mailbox; the full path is what disambiguates them): `fo