# outlook

MCP server that connects coding assistants to Microsoft Outlook and OneDrive through Microsoft Graph.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21
- Author: rlrghb
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rlrghb/olkcli
- Updated: 2026-10-17
- HTML: https://affpapa.org/en/nevibecode/mcp/outlook

## What it does

This integration connects coding agents to Microsoft services using the `olk` CLI. It supports personal Outlook.com setups alongside corporate Microsoft 365 environments. Assistants can locate email threads, check upcoming calendar slots, and browse OneDrive folders.

The package also builds HTML message drafts with embedded images under 3 MB. For safety, long-term refresh tokens stay inside the OS keychain. Without running `olk auth login` in your terminal first, the server cannot reach your mailbox.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add outlook -- npx -y olkcli
```

### Codex

**Platform CLI**
```bash
codex mcp add outlook -- npx -y olkcli
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "outlook": {
            "command": "npx",
            "args": [
                "-y",
                "olkcli"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "outlook": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "olkcli"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add outlook npx -y olkcli
```

## When to use it
- search email messages by sender or subject keywords
- generate HTML reply drafts with embedded images
- check upcoming calendar agenda for the week
- browse folders and files stored in OneDrive

## Example prompts
- Search my Outlook inbox for urgent emails sent this morning
- Show my calendar agenda for the next 7 days
- Draft a reply to message ID 12345 with the revised project summary

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md