Log inSubmit server
Office Outlook MCP logo

Office Outlook MCP

office-outlook-mcp MCP server lets agents manage Outlook mail, calendars, contacts and tasks through confirmation-gated tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Office Outlook MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "office-outlook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/office-outlook-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 30 tools correctly (21d ago).

Overview

The office-outlook-mcp MCP server connects AI clients to Outlook and Microsoft 365 mail, folders, calendars, contacts, and tasks. It captures a short-lived access token from a signed-in Chrome tab through ContextMint Bridge, then makes server-side requests to Outlook's REST API. Read tools inspect mailbox data, while outbound changes require confirmation by default. Reach for it when an agent needs to triage mail, schedule meetings, manage tasks, or export Outlook data.

Use cases

  • Triage unread Outlook messages
  • Draft and send confirmed email
  • Find meeting times and create Teams events
  • Export mail or calendar data
  • Review contacts, tasks, and mailbox settings

Key features

  • Outlook mail and folder management
  • Calendar events and Scheduling Assistant availability
  • Contacts, people, categories, and tasks
  • Confirmation-gated write operations
  • JSONL or Markdown mail and calendar exports
  • Browser-token capture with optional direct token configuration

Tools30

What Office Outlook MCP lets your agent do. Expand a tool for its parameters.

Verified live~11.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 31d

What it can do

From the 30 tools this server returned when we ran it; 30 declare their own safety hints.

Runs commands · 2Can delete or modify data · 5Handles credentials · 13Makes network requests · 30Read-only tools · 23
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age31 days
Maintainers1

Observed 2026-10-22 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · @chrischall/office-outlook-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads3.5kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed30Callable tools this server registers over MCP.
Directory activity11 viewsConfig copies, upvotes, and views on AllMCPs.

How Office Outlook MCP works

What the office-outlook-mcp MCP server does

The office-outlook-mcp MCP server exposes Outlook and Microsoft 365 operations through MCP. Its coverage includes mail folders and messages, unread mail, attachments, calendars and events, contacts and people, categories, tasks, mailbox settings, profile information, meeting availability, and mailbox health checks.

Read operations include listing and retrieving records. Write operations can send or draft messages, mark or move mail, update messages, create or modify events, respond to invitations, delete events, and reply to messages. Sending and other externally visible changes are confirmation-gated by default. Draft-only actions and certain changes that affect only the user's own calendar do not require the same approval.

How it works

The office-outlook-mcp MCP server obtains an Outlook bearer token from a signed-in browser tab through the ContextMint Bridge extension and the fetchproxy protocol. The browser is used for token capture rather than for each Outlook request. After capture, the server calls the Outlook REST endpoint directly, and the token is cached in a file with restricted permissions so restarts do not always require another capture.

A pre-obtained token can replace browser capture, which is useful for controlled or automated environments. Such tokens last roughly 25 hours and cannot be refreshed automatically. Read results default to a compact view, with full and raw views available. Mail and calendar content originating from other people is marked as untrusted data so models are instructed not to treat it as executable guidance.

Setup and configuration

Install the package globally with npm, along with the fetchproxy CLI. Chrome is currently required for the browser-based flow, and the ContextMint Bridge extension must be installed separately. On the first capture, the user approves a six-digit pairing code in the extension. The bridge and CLI must use compatible fetchproxy protocol versions.

The server can run from an MCP client's standard local-process configuration. The README provides an opencode configuration using npx -y @chrischall/office-outlook-mcp; opencode 2 and current opencode 1 use that servers form, while older opencode 1 releases may require the flat mcp form. Do not combine both forms in one configuration file.

All configuration variables are optional. OUTLOOK_ACCESS_TOKEN supplies a token directly, and OUTLOOK_DISABLE_FETCHPROXY=1 disables browser capture. Other settings control the API base URL, fetchproxy port, capture timeout, token caching, token-file location, and export directory. The export directory must be absolute, and per-call destinations must remain inside it when the variable is set.

Tools and capabilities

Mail tools list folders, messages, unread messages, and attachments; retrieve individual messages or attachments; create drafts; send, reply to, update, move, or mark messages; and export mail as JSONL or Markdown. Calendar tools list calendars and events, retrieve event details, find mutually available meeting times, inspect busy schedules, create or update events, respond to invitations, delete events, and export calendar data.

Meeting suggestions include arguments that can be passed directly to event creation. New events add a Microsoft Teams meeting by default unless disabled. Events can also be inspected for organizer status, response state, cancellation state, recurrence type, availability, and all-day status. Contact, people, category, task, profile, mailbox-settings, and health-check tools cover the remaining read and diagnostic operations.

Limitations and notes

The Outlook REST base URL defaults to https://outlook.office.com/api/v2.0, and the access token is short-lived. Safari support is not available in the documented setup. Only the organizer can update a meeting. Deleting an organized event can notify attendees, while received invitations should be declined through the invitation-response tool instead.

Every mutating tool shows a preview containing the action, HTTP method, path, and request body before approval. Clients that cannot display a native confirmation prompt should keep the default MCP_CONFIRM_MODE=ask-user behavior and pass the confirmation token back only after reviewing the preview.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Office Outlook MCP

office-outlook-mcp is an MCP server that connects AI clients to Outlook and Microsoft 365 through the Outlook REST API. Its main tools read and modify mail, folders, calendars, events, contacts, people, and tasks, with confirmation required by default for sending messages and other externally visible changes.

Install `@chrischall/office-outlook-mcp` globally with npm, then install `@fetchproxy/cli` and the ContextMint Bridge Chrome extension. Configure the package as a local MCP server in your client. The first browser-token capture requires approving a six-digit pairing code in the extension.

The default authentication flow requires Chrome with ContextMint Bridge to capture an Outlook token. A browser is not needed for each API request. Set `OUTLOOK_ACCESS_TOKEN` and optionally `OUTLOOK_DISABLE_FETCHPROXY=1` to use a pre-obtained token instead.

Write tools show a confirmation preview before making changes or sending data externally. The preview includes the action, HTTP method, path, and body. Draft-only operations and some changes affecting only the user's own calendar can skip confirmation.

Yes. `outlook_create_event` adds a Teams meeting by default and returns its join link. Pass `teamsMeeting: false` to omit it. `outlook_update_event` can add Teams to an event when explicitly requested, and only the organizer can update a meeting.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOffice Outlook MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/office-outlook-mcp?style=directory)](https://allmcps.com/mcp/office-outlook-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/office-outlook-mcp"><img src="https://allmcps.com/api/badge/office-outlook-mcp?style=directory" alt="Office Outlook MCP on AllMCPs" /></a>