Outlook

Microsoft Outlook & OneDrive: curated read-first mail, calendar, contacts & file tools for agents

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "outlook-2": {
      "command": "npx",
      "args": [
        "-y",
        "outlook-2"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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

bash

brew install rlrghb/tap/olk
# or
go install github.com/rlrghb/olkcli/cmd/olk@latest

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

Terminal

npm install -g olkcli

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

Quick start

bash

olk auth login
olk auth status
olk mail list --json --results-only --select id,subject,from
olk mail search 'from:person@example.com subject:urgent'
olk calendar view --days 7
olk contacts search "Alex"
olk todo lists list
olk drive ls

For work/school accounts and enterprise-only features:

bash

olk auth login --enterprise

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:person@example.com 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 person@example.com --subject "Hi" --body "Hello"`
Draft HTML with an inline image	`olk mail drafts create --to person@example.com --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 person@example.com --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.

bash

olk mail list --json --results-only | jq '.[].subject'
olk contacts list --plain

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

bash

make build
make test
make lint

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

License

See LICENSE.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Communication View all alternatives

Reviews

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

Frequently Asked Questions about Outlook

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "outlook": { "command": "npx", "args": ["-y", "outlook"] } }

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 Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/outlook-2?style=directory)](https://allmcps.com/mcp/outlook-2)

HTML Embed

<a href="https://allmcps.com/mcp/outlook-2"><img src="https://allmcps.com/api/badge/outlook-2?style=directory" alt="Outlook on AllMCPs" /></a>

Technical Specs & Signals

CategoryCommunication

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💬 Communication →Best MCP servers for Slack & Communication →Alternatives to Outlook →Install in Claude Desktop Install in Cursor Install in VS Code

Outlook

Microsoft Outlook & OneDrive: curated read-first mail, calendar, contacts & file tools for agents

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "outlook-2": {
      "command": "npx",
      "args": [
        "-y",
        "outlook-2"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

olk — Microsoft Outlook in Your Terminal

Install

bash

brew install rlrghb/tap/olk
# or
go install github.com/rlrghb/olkcli/cmd/olk@latest

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

Terminal

npm install -g olkcli

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

Quick start

bash

olk auth login
olk auth status
olk mail list --json --results-only --select id,subject,from
olk mail search 'from:person@example.com subject:urgent'
olk calendar view --days 7
olk contacts search "Alex"
olk todo lists list
olk drive ls

For work/school accounts and enterprise-only features:

bash

olk auth login --enterprise

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:person@example.com 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 person@example.com --subject "Hi" --body "Hello"`
Draft HTML with an inline image	`olk mail drafts create --to person@example.com --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 person@example.com --subject "Instructions" --html \
  --body '<p>Follow these steps:</p><img src="cid:steps">' \
  --inline steps=steps.png

Output and scripting

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

bash

olk mail list --json --results-only | jq '.[].subject'
olk contacts list --plain

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

bash

make build
make test
make lint

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

License

See LICENSE.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Communication View all alternatives

Reviews

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

Frequently Asked Questions about Outlook

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "outlook": { "command": "npx", "args": ["-y", "outlook"] } }

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 Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/outlook-2?style=directory)](https://allmcps.com/mcp/outlook-2)

HTML Embed

<a href="https://allmcps.com/mcp/outlook-2"><img src="https://allmcps.com/api/badge/outlook-2?style=directory" alt="Outlook on AllMCPs" /></a>

Technical Specs & Signals

CategoryCommunication

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💬 Communication →Best MCP servers for Slack & Communication →Alternatives to Outlook →Install in Claude Desktop Install in Cursor Install in VS Code