outlook-web-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
outlook-web-mcp
An MCP server that lets an AI assistant (Claude Code, Claude Desktop or any MCP client) work in Outlook on the web by driving a browser that you have signed in to: list and read mail, triage folders, search, draft replies, send drafts you approve, and read your calendar.
It does not use Microsoft Graph and needs no app registration or admin consent. It clicks, types and reads the page the way you would, so it can do exactly what you can do in Outlook on the web and nothing more. That makes it useful where an organisation blocks third-party mail apps but you still want an assistant to help with your own mailbox.
Check your organisation's rules first. Driving your own signed-in browser is not the same as an approved integration. If your IT policy forbids automating your mailbox, don't use this.
How it works
MCP client ──stdio──▶ src/server.mjs ──CDP (localhost)──▶ Chromium on a virtual display
▲
you, via noVNC ───────────┘ (sign in, approve MFA, watch)browser/start-browser.shruns Chromium on a virtual display (Xvfb) with a persistent profile, so sign-ins survive restarts. It exposes:the Chrome DevTools Protocol on
127.0.0.1only, for the MCP server;a password-protected noVNC viewer, so you can sign in, approve MFA and watch or take over from any browser (phone included). Put it on a private network such as Tailscale, not the open internet.
src/server.mjsconnects over CDP and drives the Outlook tab with Playwright. Tools run one at a time on that one tab.
It also works with an ordinary desktop Chrome started with --remote-debugging-port=9222.
Related MCP server: outlook-mcp
Tools
Tool | What it does |
| Signed in or not, and the current page |
| Signs in again with the browser's saved password (autofill; never read) and returns the MFA number to approve (Okta Verify or Microsoft Authenticator number matching) |
| Folder tree with unread and item counts |
| Conversations in a folder: pinned ones separately, then the newest |
| A whole conversation by id (marks it read unless asked not to) |
| Every unread conversation in one folder or in all folders, marking each read |
| Outlook search ( |
| Read, unread, flag, unflag, pin, unpin, archive, delete |
| Reply, reply-all or forward, saved as a draft |
| New email saved as a draft |
| Recipients, subject and text of a draft, to check before sending |
| Sends a draft. Off unless |
| Throws a draft away |
| List a conversation's attachments, download them to a local folder, or Save to OneDrive |
| Look people up in contacts and the organisation directory: name, title, email, phone |
| Events for a range of days |
| One event in full: organiser, attendees and responses, location, Teams link, description |
| Accept, tentative or decline an invitation, optionally with a note. Needs |
| New event: title, date, times or all day, location, Teams meeting, description; attendees get invitations (needs |
| Delete an event; for a meeting you organised, sends the cancellation (needs |
| What the Outlook tab looks like right now |
Drafting and sending are separate on purpose: the assistant writes a draft, you read it (in Outlook or through outlook_read_draft), and only then is it sent. Everything else that emails other people (invitation responses, invitations, cancellations) is behind the same OUTLOOK_ENABLE_SEND switch.
Setup (Linux)
Tested on Ubuntu 24.04 with Node 22.
sudo apt-get install -y xvfb x11vnc novnc websockify
git clone https://github.com/astewartau/outlook-web-mcp && cd outlook-web-mcp
npm install
npx playwright install chromium
# a password for the viewer (x11vnc uses the first 8 characters)
mkdir -p ~/.config/outlook-web-mcp && x11vnc -storepasswd ~/.config/outlook-web-mcp/vncpass
# start it (or install browser/outlook-browser.service as a systemd user unit)
VIEW_ADDR=<your Tailscale IP> browser/start-browser.shOpen http://<VIEW_ADDR>:6080/vnc.html?autoconnect=1&resize=scale, sign in to Outlook, and let Chromium save your password if you want outlook_login to handle expired sessions.
Ubuntu 23.10+: if Chromium exits with No usable sandbox!, install browser/apparmor-chromium (instructions inside). It lets that one binary use its sandbox; don't run with --no-sandbox for a browser that holds your mail.
start-browser.sh settings (environment): VIEW_ADDR, VIEW_PORT (6080), CDP_PORT (9222), DISPLAY_NUM (77), PROFILE_DIR, VNC_PASSFILE, CHROME, START_URL, SIZE.
Adding it to Claude Code
claude mcp add -s user outlook-web \
-e OUTLOOK_ACCOUNT=you@example.edu -e OUTLOOK_TIMEZONE=Australia/Brisbane -e OUTLOOK_ENABLE_SEND=1 \
-- node /path/to/outlook-web-mcp/src/server.mjsVariable | Default | |
|
| Browser to drive |
|
| Outlook address ( |
| Account to pick on the Microsoft sign-in page | |
| system zone | Defines "today" for |
| off | Allow tools that email other people: sending drafts, invitation responses, invitations, cancellations |
|
| Where attachments are downloaded |
skills/outlook-email/SKILL.md is a Claude Code skill with working rules (triage, drafting, when sending is allowed). Copy it to ~/.claude/skills/outlook-email/.
Test a tool without an MCP client: node scripts/call.mjs outlook_folders '{}'.
Limitations
It depends on Outlook's page structure (ARIA roles and labels). When Microsoft changes the page, selectors may need updating. It was built against the new Outlook on the web in English (late 2026).
One tab and one action at a time; reading a long folder takes seconds, not milliseconds.
Events are same-day (no multi-day or recurring events yet). The calendar ignores dates in its URL, so the tools page through the mini calendar.
outlook_event_respondwith a note goes through Outlook's "RSVP with note" dialog.If the site ever publishes WebMCP tools, those would be the better route.
Licence
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Your own AI reads, searches and drafts in your mailbox, on your Windows computer.
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Connect Gmail, iCloud Mail, Outlook, Yahoo Mail, Fastmail and other IMAP inboxes to ChatGPT, Claude and compatible AI assistants. Find emails by meaning across languages with semantic search. Ask AI to find customer conversations, summarize deadlines and draft follow-ups. Give a sales rep access to a shared outreach inbox or bring email into a compatible CRM. Share an iCloud custom-domain inbox with teammates without their own Apple ID or iCloud+ plan. Search results may be incomplete or stale; separate permissions control mail actions.
Web search, data extraction and controlled browser automation for AI assistants via OAuth.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables AI assistants to manage Microsoft Outlook email and calendar through the Microsoft Graph API, including reading, sending, searching emails, and handling calendar events.4331MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read, send, and manage Outlook mail locally on Windows via COM/MAPI, without cloud APIs.1MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to securely read, search, draft, and send Outlook emails, manage calendar events, and access mailbox folders through a local MAPI connection to Windows Outlook, with human-in-the-loop safeguards.91MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage Microsoft Outlook Desktop (Classic) calendar and email through local COM automation, without Microsoft Graph or Entra registration.MIT