Outlook

io.github.rlrghbPublished by GitHub account rlrghbv1.16.1Updated Oct 24, 2026

Outlook & OneDrive MCP: personal & enterprise tools for mail, calendar, contacts, tasks, files

VerifiedSTDIODesktop onlyProductivity & Workflow Files & Storage Communication & Collaboration

Server details

Identifier: io.github.rlrghb/outlook
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account rlrghb for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.rlrghb%2Foutlook.svg)](https://sourceweft.com/mcp/io.github.rlrghb%2Foutlook?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server and CLI that gives an assistant access to Outlook mail, calendar, contacts, tasks and OneDrive through Microsoft Graph.

What you can do: Read and search mail, including message IDs, subjects and senders, and synchronize changes across the mailbox and other resources via Microsoft Graph, with JSON, TSV or table output for scripting and field selection to limit results. View calendar events for a chosen number of days. Search and list contacts. List task lists and browse OneDrive files. Draft, reply, reply-all, send and forward mail, including HTML drafts with inline images, with mutations exposed over MCP only after explicit opt-in. Wrap external mail, calendar, contact and file text as untrusted content for safer agent consumption.
When to use it: Useful when an assistant should work with a personal Outlook.com or enterprise Microsoft 365 account: triaging and searching mail, checking upcoming calendar events, looking up contacts, managing tasks, browsing OneDrive, or preparing drafts and replies. Read-only unattended runs are supported through flags that disable writes, sends and prompts.
Requirements: Runs as a local process; install via Homebrew, Go, or the npm package olkcli, which provides the olk command. Sign-in is required through the CLI's auth login, with an enterprise option for work or school accounts. On macOS, Keychain access may be requested after an upgrade. Network access to Microsoft Graph is needed.

Before you install

The server can send, forward and draft mail and otherwise change mailbox data; mutations over MCP require explicit opt-in, and read-only flags exist for unattended runs. Refresh tokens are stored in the OS keychain and access tokens in memory. Mail, calendar, contact and file content comes from third parties and can be wrapped as untrusted. Review the security and privacy guide before connecting an agent or sharing logs.

Installation

In SourceWeft

Open Outlook in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

olk — Microsoft Outlook in Your Terminal

olk is a scriptable CLI and MCP server for Outlook mail, calendars, contacts, tasks, and OneDrive through Microsoft Graph. It works with personal Outlook.com accounts and enterprise Microsoft 365 accounts.

Install

The npm package is olkcli; the installed command is olk:

See macOS notes if macOS asks for Keychain access after an upgrade.

Quick start

bash

olk auth loginolk auth statusolk mail list --json --results-only --select id,subject,fromolk mail search 'from:[email protected] subject:urgent'olk calendar view --days 7olk contacts search "Alex"olk todo lists listolk drive ls

olk auth loginolk auth statusolk mail list --json --results-only --select id,subject,fromolk mail search 'from:[email protected] subject:urgent'olk calendar view --days 7olk contacts search "Alex"olk todo lists listolk drive ls

For work/school accounts and enterprise-only features:

Common commands

Need	Command
Check the signed-in account	`olk auth status` or `olk whoami`
Find message IDs and subjects	`olk mail list --json --results-only --select id,subject,from`
Search mail	`olk mail search "from:[email protected] subject:urgent"`
View the next week	`olk calendar view --days 7`
Search contacts	`olk contacts search "Alex"`
List task lists	`olk todo lists list`
Browse OneDrive	`olk drive ls`
Send mail	`olk mail send --to [email protected] --subject "Hi" --body "Hello"`
Draft a reply-all with an extra Cc	`olk mail reply <ID> --reply-all --draft --body "$(cat reply.txt)" --cc [email protected]`
Draft HTML with an inline image	`olk mail drafts create --to [email protected] --subject "Steps" --html --body '<img src="cid:steps">' --inline steps=steps.png`
Synchronize changes	`olk changes --json`
Use JSON for scripts	`olk mail list --json --results-only`
Use as an MCP server	`olk mcp`

See the command reference for all commands and flags.

Inline images in HTML drafts

Use a cid: URL in the HTML and supply the matching image with repeatable --inline CID=PATH flags. This works for new drafts and true threaded reply or reply-all drafts:

bash

olk mail reply <ID> --draft --html \  --body '<p>See both images:</p><img src="cid:logo"><img src="cid:steps">' \  --inline logo=logo.png --inline steps=steps.png
olk mail drafts create --to [email protected] --subject "Instructions" --html \  --body '<p>Follow these steps:</p><img src="cid:steps">' \  --inline steps=steps.png

olk mail reply <ID> --draft --html \  --body '<p>See both images:</p><img src="cid:logo"><img src="cid:steps">' \  --inline logo=logo.png --inline steps=steps.png
olk mail drafts create --to [email protected] --subject "Instructions" --html \  --body '<p>Follow these steps:</p><img src="cid:steps">' \  --inline steps=steps.png

Each CID must be unique and referenced by the HTML. Files must be images and each must be under 3 MB, the Microsoft Graph simple-attachment limit. Draft commands do not send mail; immediate sends and forwards do not accept --inline.

Output and scripting

Results are written to stdout; diagnostics and prompts go to stderr.

Output modes are JSON (--json), TSV (--plain), and aligned tables by default. Use --concise to omit large bodies/previews and --select to limit fields where supported. See scripting and sync.

Safety defaults

Use --no-write --no-send --no-input for unattended read-only runs.
MCP exposes curated tools and requires explicit opt-in for mutations.
External mail, calendar, contact, and file text can be wrapped with --wrap-untrusted for agent-safe consumption.
Refresh tokens are stored in the OS keychain; access tokens are kept in memory only.

Read the security and privacy guide before connecting an agent or sharing logs.

Documentation

Contributing

See development and releases for repository structure, validation, CI, and publishing details.

License

See LICENSE.

Source: README.md at commit 6228443

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.16.1LatestOct 12, 2026
v1.15.1Sep 26, 2026
v1.15.0Sep 24, 2026
v1.14.0Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts