# Outlook MCP server

> Allows an AI client to manage Microsoft Outlook mail, calendars, contacts, tasks, and OneDrive files via Microsoft Graph.

- Repository: https://github.com/rlrghb/olkcli
- Page: https://hostedmcp.org/servers/rlrghb/olkcli
- Transport: stdio
- Stars: 23
- License: MIT
- Latest version: 1.16.3

## Install

### Claude Code

```sh
claude mcp add olkcli -- npx -y olkcli
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "olkcli": {
      "command": "npx",
      "args": [
        "-y",
        "olkcli"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "olkcli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "olkcli"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"olkcli","type":"stdio","command":"npx","args":["-y","olkcli"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "olkcli": {
      "command": "npx",
      "args": [
        "-y",
        "olkcli"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add olkcli -- npx -y olkcli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.olkcli]
command = "npx"
args = ["-y", "olkcli"]
```

### Gemini CLI

```sh
gemini mcp add -s user olkcli npx -- -y olkcli
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "olkcli": {
      "command": "npx",
      "args": [
        "-y",
        "olkcli"
      ]
    }
  }
}
```

## Tools (39)

- `calendar_attachments_list`: List event attachments (read-only)
- `calendar_availability`: Check availability / free-busy (read-only)
- `calendar_calendars`: List available calendars (read-only)
- `calendar_delta`: Incremental sync of calendar events (delta) (read-only)
- `calendar_events`: List calendar events (read-only)
- `calendar_find_times`: Find available meeting times (read-only)
- `calendar_get`: Get event details (read-only)
- `calendar_view`: Calendar view with expanded recurring events (read-only)
- `changes`: Unified delta digest across mail, calendar, and contacts (read-only)
- `contacts_delta`: Incremental sync of contacts (delta) (read-only)
- `contacts_get`: Get contact details (read-only)
- `contacts_list`: List contacts (read-only)
- `contacts_search`: Search contacts (read-only)
- `drive_get`: Get item details (read-only)
- `drive_info`: Show drive details and quota (read-only)
- `drive_ls`: List folder contents (read-only)
- `drive_recent`: Recently accessed files (read-only)
- `drive_search`: Search files (read-only)
- `drive_shared`: Files shared with me (read-only)
- `drive_versions`: List file version history (read-only)
- `mail_attachments`: List/download attachments (read-only)
- `mail_batch`: Fetch up to 20 messages by ID in one request ($batch) (read-only)
- `mail_categories_list`: List available categories (read-only)
- `mail_delta`: Incremental sync of a mail folder (delta) (read-only)
- `mail_folders_list`: List all visible mail folders recursively (read-only)
- `mail_get`: Get a message (read-only)
- `mail_list`: List messages in inbox (read-only)
- `mail_ooo_get`: Get auto-reply settings (read-only)
- `mail_rules_list`: List inbox rules (read-only)
- `mail_search`: Search messages (read-only)
- `mail_thread`: List all messages in a conversation thread (read-only)
- `people_search`: Search people directory (read-only)
- `todo_checklist_list`: List checklist items (read-only)
- `todo_get`: Get task details (read-only)
- `todo_links_list`: List linked resources (read-only)
- `todo_list`: List tasks in a list (read-only)
- `todo_lists_list`: List task lists (read-only)
- `version`: Show version information (read-only)
- `whoami`: Show current user profile (read-only)

## FAQ

### What accounts are supported?

It works with both personal Outlook.com accounts and enterprise Microsoft 365 accounts.

### How are authentication tokens handled?

Refresh tokens are stored in your operating system's keychain, while access tokens are kept only in memory.

### Is there a way to run the tool without making changes?

Yes, you can use specific flags to ensure unattended runs are read-only.
