office-outlook-mcp
MCP server for Outlook / Microsoft 365 — mail, folders, calendar, contacts and tasks, with confirmation-gated sending.
This project was developed and is maintained by AI (Claude Code). Use at your own discretion.
Power your agent
पब्लिशर की अपनी कमांड। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
npx -y @chrischall/[email protected]Claude Code में लोकल कमांड के लिए इंस्टॉल लिंक नहीं है। नीचे दी गई कमांड कॉपी करें और टर्मिनल में चलाएँ।
claude mcp add chrischall-office-outlook-mcp -- npx -y @chrischall/office-outlook-mcp@0.13.0टर्मिनल में चलाएँ।
{ "mcpServers": { "chrischall-office-outlook-mcp": { "command": "npx", "args": [ "-y", "@chrischall/[email protected]" ] } }}claude_desktop_config.json
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
MCP server for Outlook / Microsoft 365 — mail, folders, calendar, contacts and tasks, with confirmation-gated sending.
This project was developed and is maintained by AI (Claude Code). Use at your own discretion.
Outlook / Microsoft 365 MCP server for Claude — developed and maintained by AI (Claude Code)
Outlook Web holds its access token in memory and sends it as
Authorization: Bearer …. This server snapshots that header from your
signed-in browser tab through the fetchproxy
bridge, then talks to https://outlook.office.com/api/v2.0 with ordinary
server-side requests.
The browser is needed only to mint the token (~25h), never to make a call. That is the whole design: no Azure app registration, no admin consent, and no browser on the request path.
Tokens are cached at ~/.office-outlook-mcp/token.json (0600), so a restart
does not re-capture.
npm i -g @chrischall/office-outlook-mcp
Requires the ContextMint Bridge browser extension, installed from
its releases:
in Chrome, unzip the chrome build and load it unpacked
(chrome://extensions → Developer mode → Load unpacked). Safari is not
available yet — it will ship inside the ContextMint app, which has no public
download — so use Chrome for now.
ContextMint Bridge is the fetchproxy browser extension under its new name, from
the same maintainer — fetchproxy's own README
(#extension) points to it.
Its source is public at
nullnet-app/contextmint-bridge:
build it yourself, or check a release zip against the .sha256 file published
beside it (shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256).
The extension, fpx and this server are compatible by fetchproxy protocol
number (currently protocol 4), not by matching package versions. Keep the
bridge and fpx current — a mismatch fails with an error naming both protocol
numbers. Also install @fetchproxy/cli:
npm i -g @fetchproxy/cli
The first capture prints a 6-digit pair code to approve in the ContextMint Bridge popup; the grant persists.
opencode reads MCP servers from opencode.json (project) or
~/.config/opencode/opencode.json (global):
{
"mcp": {
"servers": {
"outlook": {
"type": "local",
"command": ["npx", "-y", "@chrischall/office-outlook-mcp"]
}
}
}
}
That one file serves opencode 2 and current opencode 1 — verified live on 2.0.11, 1.18.31 and 1.18.28, which all connect from it.
Two things worth knowing, both measured rather than assumed:
mcp ("mcp": { "outlook": { … } }), and the
temptation is to write both so either version finds one. Do not: given a
sibling key beside servers, opencode 2 parses the file — it still shows up
in opencode debug config — and then reports "No MCP servers configured".
No error, no warning, every server silently gone.servers says so loudly
(Configuration is invalid at …), so if you see that, switch that machine to
the flat shape rather than combining them.opencode 2 talks to a background service, so opencode reload before
opencode mcp list after editing config.
Everything is optional — with nothing set, the server captures from the browser.
Read — outlook_list_folders, outlook_list_messages,
outlook_get_message, outlook_list_unread_messages, outlook_list_attachments,
outlook_get_attachment, outlook_list_events, outlook_get_event,
outlook_list_calendars, outlook_find_meeting_times,
outlook_get_schedule, outlook_get_profile,
outlook_get_mailbox_settings, outlook_list_contacts, outlook_list_people,
outlook_list_categories, outlook_list_tasks
Write (ask you to confirm first — see Confirmations) —
outlook_send_message, outlook_create_draft, outlook_mark_read,
outlook_update_message, outlook_move_message, outlook_create_event,
outlook_update_event, outlook_respond_to_invite, outlook_delete_event,
outlook_reply.
Some skip the confirmation because nothing reaches anyone else:
outlook_create_draft (the draft stays in Drafts until you send it from
Outlook), outlook_reply with draftOnly: true (the reply stays in Drafts),
outlook_respond_to_invite with sendResponse: false, and
outlook_delete_event on your own appointment with no attendees or on a
meeting the organizer already cancelled (in each, only your calendar
changes).
Meetings — outlook_find_meeting_times asks Outlook's Scheduling
Assistant for slots when everyone is free, and outlook_get_schedule shows
each person's busy blocks. Each suggested slot carries createEventArgs,
which outlook_create_event accepts unchanged. outlook_create_event
attaches a Microsoft Teams meeting by default and returns its join link; pass
teamsMeeting: false to leave it off. outlook_update_event never changes how
people join a meeting unless asked: pass teamsMeeting: true to add a Teams
meeting to an event that lacks one, and the confirmation says so in plain
words. Only the organizer
can update a meeting. outlook_respond_to_invite accepts, tentatively accepts
or declines an invite, by its message id or its event id.
outlook_delete_event deletes an event you organize — one occurrence by the
occurrence's id, or the whole series by its series master's id — and sends
any attendees a cancellation; for an invite you received it refuses and points
you at declining instead. outlook_list_events and outlook_get_event show
what that decision needs in every view: MyResponse, ResponseRequested,
IsOrganizer, IsCancelled, Type (SingleInstance, Occurrence, Exception or
SeriesMaster), ShowAs and IsAllDay, plus SeriesMasterId in the full view.
Export — outlook_export_messages (mail) and outlook_export_events
(calendar) write JSONL or Markdown files, optionally with attachments, and
return only where they are; see Bulk export.
Diagnostics — outlook_healthcheck
Every read tool takes view: compact | full | raw, defaulting to compact.
Mutating tools write nothing until you confirm (bar the cases above)
— see Confirmations. The preview shows exactly what would be sent
(action, method, path and body). (outlook_create_event first reads the
mailbox time zone, so its preview can name the zone it would book in; that is
the one read a preview makes.)
Mail and event text is written by other people, so outlook_list_messages,
outlook_get_message, outlook_list_unread_messages, outlook_get_attachment,
outlook_list_events, outlook_get_event, outlook_find_meeting_times,
outlook_get_schedule, outlook_export_messages and outlook_export_events
wrap every result (all views) in an untrusted-content
envelope — untrusted_content: true plus a note telling the model to treat
the text as data, never instructions (a view: raw record that carries its
own untrusted_content/note key is nested under data, so it cannot
overwrite the envelope). outlook_reply returns a sent reply's subject — the
original sender's text — inside the same envelope.
On a client that cannot show a confirmation prompt, the confirmToken is still
something the model passes back itself, so keep MCP_CONFIRM_MODE=ask-user
(the default) and approve each preview in chat — or use a client that asks you
before running non-read-only tools — as the real guard on outbound sends.
An agent can work through new mail end to end without opening Outlook:
outlook_list_unread_messages returns the unread messages in a
folder (default inbox), newest first, each with its plain-text body, in one
call. It does not mark anything read. Each item has a kind: mail,
meetingRequest, meetingCancelled or meetingResponse; requests and
cancellations also carry the linked event (time, organizer, your current
response) — or, when the meeting is no longer on your calendar (already
declined, cancelled or deleted), a hint saying there is nothing to respond
to. to and cc list at most 20 addresses, with toCount/ccCount when
there are more.outlook_respond_to_invite with the message id and
accept, tentative or decline (and an optional comment). Once you
respond, Outlook moves the invite message to Deleted Items under a new
id, so an answered invite is already filed — skip steps 3 and 4 for it
(its old id would 404);outlook_reply (reply, replyAll or
forward), or draftOnly: true to leave it in Drafts for you to review;outlook_find_meeting_times for the attendees,
then pass the chosen slot's createEventArgs to outlook_create_event;outlook_get_attachment.outlook_update_message flags, categorises (names from
outlook_list_categories) and marks read up to 50 messages in one call;
outlook_move_message moves one to another folder.outlook_mark_read (or isRead: true on
outlook_update_message) on the plain mail you handled, so the next
outlook_list_unread_messages returns only what is still new. Answered invites are
already out of the inbox (see step 2).Replies, forwards, invite responses and new meetings reach other people, so
each asks you to confirm first — except a reply saved with draftOnly: true
(it stays in Drafts until you send it) and an invite response with
sendResponse: false (only your calendar changes; the organizer is not told).
outlook_list_unread_messages and outlook_list_messages also page oldest first
from a point in time: pass from as an ISO 8601 UTC time
(2026-10-01T00:00:00Z). The result carries next_from — pass it back
unchanged as from for the next page — and has_more. To backfill, start
from an old time and keep passing next_from until has_more is false; then
keep polling with the last next_from to pick up new mail (an empty page
returns the same position). Messages that share a timestamp are never skipped
or repeated across pages, and marking mail read between pages loses nothing.
from cannot be combined with nextLink, sinceHours, search or skip.
outlook_export_messages exports mail and outlook_export_events exports
the calendar in bulk, thousands of records at a time, and none of their text
enters the conversation. The server pages the mailbox (or calendar) and writes
the records to files. The tool returns only a small manifest: where the files
are, their sizes, the record and attachment counts, the date span, and
has_more plus a cursor. Have the agent read the files with shell tools
(jq, grep, rg, head) rather than opening them whole.
folder (a well-known name such as inbox or
sentitems, or a folder id; all exports the whole mailbox; default
inbox), since and until (ISO 8601), search (full-text, spans the
mailbox). Mail is exported oldest first.since and until (ISO 8601, both required, at most
two years apart) and calendar (a calendar id; default, the default
calendar). Events come from the calendar view, so a recurring series is
expanded into its individual occurrences. Times are wall-clock times in the
mailbox's time zone, named on each record as time_zone.format (jsonl, the default, or markdown), attachments
(default false), dest, cursor, max_items (default 5000, max 50000)
and budget_seconds (default 90, max 600).part-0001.jsonl holds one JSON record per message (id,
conversation id, subject, from, to/cc/bcc, dates, flags, categories, web link
and the full plain-text body). Its first line is an _export header that
names the source, account, arguments and an untrusted-content note.
An event record carries the id, iCal UID, type and series id, subject,
start, end, time zone, location, organizer, attendees with their responses,
your response, show-as, categories, the join link and the full plain-text
body.
format: "markdown" writes part-0001.md, a readable transcript (one
section per message or event), instead.
manifest.json lists the counts and any errors, and the files: on disk
every part's files (it is rewritten as each part finishes); in a blob zip
the files in that zip.attachments: true, each file attachment of up to
50 MB is saved as attachments/<short id>/<name> (the name sanitized), and
the record lists its attachments, each with its relative path, or with
skipped and the reason. Attached Outlook items (a forwarded email or
event), cloud-file links (OneDrive/SharePoint), larger files and failed
downloads are skipped. One bad attachment never fails the export.max_items or budget_seconds, whichever
comes first. While has_more is true, pass cursor back unchanged. The
next call continues the same export as part-0002, part-0003 and so on.
With attachments on, the budget is checked between small groups of
records, so a stop can fall inside a page; the cursor resumes at the next
record. If Outlook refuses the credential (including while downloading an
attachment), or keeps returning 429 after three
Retry-After waits, the call keeps what it already wrote and returns the
cursor. Re-authenticate, then resume.Where the files go depends on how the server runs:
On disk, <dir> is the per-call dest, else OUTLOOK_OUTPUT_DIR, else
~/Downloads/office-outlook-mcp. A dest must be inside OUTLOOK_OUTPUT_DIR
when that is set. Otherwise it must be inside ~/Downloads, ~/Documents or
~/Desktop. A resumed cursor's directory is checked against the same roots
again.
Every write asks you to confirm before anything is sent or changed (except a
new draft, a draft-only reply and a silent invite response — see
Tools). A client
that can show a confirmation prompt (Claude Code) shows one. On a client that
cannot, the first call does nothing and returns a confirmation-required
preview plus a confirmToken; only a repeat call with that token performs the
write. The token is single-use, expires, and is bound to the exact arguments —
change anything between the two calls and it is refused (DRAFT_CHANGED) with
a fresh preview.
ReceivedDateTime, IsRead). This is the Outlook
REST API, not Graph — a Graph snippet silently returns nothing.outlook_get_message returns a plain-text body by default, measured 9.4×
smaller than the HTML; pass html: true for the original.outlook_list_events uses the calendar view, which expands recurring
series. /me/events does not, which is why it is not exposed as-is.Eastern Standard Time), not IANA.search and unreadOnly cannot be combined; the API rejects $search
alongside $filter, so the tool refuses before making a doomed request.outlook_list_events returns times in the mailbox's own time zone unless
timeZone overrides it. The API itself defaults to UTC, which silently reads
as a four-hour error on an Eastern mailbox.MobilePhone1, not Graph's MobilePhone. The v2.0
Contact type rejects the Graph name with a 400.If you only need Outlook access from Claude Code on this machine, the
skills/outlook-fpx access skill in this repo does the same reads with fpx +
curl and no server at all. The MCP earns its keep when you want typed tools,
confirmation-gated writes, or reach from claude.ai.
npm install
npm run build
npm test # typecheck + suite
npm run test:coverage # CI's gate
Request shapes are pinned in docs/OUTLOOK-API.md, all
verified against a live mailbox.
MIT
Outlook / Microsoft 365 MCP server for Claude — developed and maintained by AI (Claude Code)
{ "mcpServers": { "chrischall-office-outlook-mcp": { "command": "npx", "args": [ "-y", "@chrischall/[email protected]" ] } }}टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
@chrischall/office Outlook stdio पर लोकल चलता है।
पिछली जाँच 2026-11-17 को हुई। Outlook / Microsoft 365 MCP server for Claude — developed and maintained by AI (Claude Code)