Outlook Mailbox Tidier MCP Server

Name: Outlook Mailbox Tidier MCP Server
Author: io.github.ma2no4413

io.github.ma2no4413/outlook-mcp

Repository Registry

What is the Outlook Mailbox Tidier MCP server?

Tidy a large Outlook / Hotmail mailbox. Folder subtree moves, bulk ops with dry run, never sends.

How to install Outlook Mailbox Tidier

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OUTLOOK_CLIENT_ID
required
Application (client) ID from the Azure app registration. See docs/AZURE.en.md for how to obtain one.
OUTLOOK_TOKEN_CACHE
secret
Path to the token cache file. In Docker, point this at a mounted volume so the sign-in survives restarts. The file is the key to the mailbox; never bake it into an image.
OUTLOOK_TENANT
common for personal and work/school accounts, consumers for personal Microsoft accounts only. Defaults to common.
OUTLOOK_READONLY
Set to true to disable every write tool at once, leaving only search and read.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "outlook-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ma2no4413/outlook-mcp:0.2.7"
      ],
      "env": {
        "OUTLOOK_CLIENT_ID": "<YOUR_OUTLOOK_CLIENT_ID>",
        "OUTLOOK_TOKEN_CACHE": "<YOUR_OUTLOOK_TOKEN_CACHE>",
        "OUTLOOK_TENANT": "<YOUR_OUTLOOK_TENANT>",
        "OUTLOOK_READONLY": "<YOUR_OUTLOOK_READONLY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "outlook-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ma2no4413/outlook-mcp:0.2.7"
      ],
      "env": {
        "OUTLOOK_CLIENT_ID": "<YOUR_OUTLOOK_CLIENT_ID>",
        "OUTLOOK_TOKEN_CACHE": "<YOUR_OUTLOOK_TOKEN_CACHE>",
        "OUTLOOK_TENANT": "<YOUR_OUTLOOK_TENANT>",
        "OUTLOOK_READONLY": "<YOUR_OUTLOOK_READONLY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "outlook-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ma2no4413/outlook-mcp:0.2.7"
      ],
      "env": {
        "OUTLOOK_CLIENT_ID": "<YOUR_OUTLOOK_CLIENT_ID>",
        "OUTLOOK_TOKEN_CACHE": "<YOUR_OUTLOOK_TOKEN_CACHE>",
        "OUTLOOK_TENANT": "<YOUR_OUTLOOK_TENANT>",
        "OUTLOOK_READONLY": "<YOUR_OUTLOOK_READONLY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "outlook-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ma2no4413/outlook-mcp:0.2.7"
      ],
      "env": {
        "OUTLOOK_CLIENT_ID": "<YOUR_OUTLOOK_CLIENT_ID>",
        "OUTLOOK_TOKEN_CACHE": "<YOUR_OUTLOOK_TOKEN_CACHE>",
        "OUTLOOK_TENANT": "<YOUR_OUTLOOK_TENANT>",
        "OUTLOOK_READONLY": "<YOUR_OUTLOOK_READONLY>"
      }
    }
  }
}

Claude Code

claude mcp add outlook-mcp --env OUTLOOK_CLIENT_ID=<YOUR_OUTLOOK_CLIENT_ID> --env OUTLOOK_TOKEN_CACHE=<YOUR_OUTLOOK_TOKEN_CACHE> --env OUTLOOK_TENANT=<YOUR_OUTLOOK_TENANT> --env OUTLOOK_READONLY=<YOUR_OUTLOOK_READONLY> -- docker run -i --rm ghcr.io/ma2no4413/outlook-mcp:0.2.7