Outlook Mailbox Tidier MCP Server

by ma2no4413io.github.ma2no4413/outlook-mcpv0.2.7

Restructure large Outlook/Hotmail mailboxes: move folder subtrees, bulk move and mark-read with dry-run previews, and manage inbox rules. Cannot send mail.

0Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained48d ago

Install Outlook Mailbox Tidier MCP server

claude mcp add outlook-ma2no4413 -e OUTLOOK_CLIENT_ID='<outlook-client-id>' -e OUTLOOK_TOKEN_CACHE='<outlook-token-cache>' -- docker run -i --rm -e OUTLOOK_CLIENT_ID -e OUTLOOK_TOKEN_CACHE ghcr.io/ma2no4413/outlook-mcp:0.2.7

{
  "mcpServers": {
    "outlook-ma2no4413": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OUTLOOK_CLIENT_ID",
        "-e",
        "OUTLOOK_TOKEN_CACHE",
        "ghcr.io/ma2no4413/outlook-mcp:0.2.7"
      ],
      "env": {
        "OUTLOOK_CLIENT_ID": "<outlook-client-id>",
        "OUTLOOK_TOKEN_CACHE": "<outlook-token-cache>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "outlook-ma2no4413": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OUTLOOK_CLIENT_ID",
        "-e",
        "OUTLOOK_TOKEN_CACHE",
        "ghcr.io/ma2no4413/outlook-mcp:0.2.7"
      ],
      "env": {
        "OUTLOOK_CLIENT_ID": "<outlook-client-id>",
        "OUTLOOK_TOKEN_CACHE": "<outlook-token-cache>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "outlook-ma2no4413": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OUTLOOK_CLIENT_ID",
        "-e",
        "OUTLOOK_TOKEN_CACHE",
        "ghcr.io/ma2no4413/outlook-mcp:0.2.7"
      ],
      "env": {
        "OUTLOOK_CLIENT_ID": "<outlook-client-id>",
        "OUTLOOK_TOKEN_CACHE": "<outlook-token-cache>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "outlook-ma2no4413": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OUTLOOK_CLIENT_ID",
        "-e",
        "OUTLOOK_TOKEN_CACHE",
        "ghcr.io/ma2no4413/outlook-mcp:0.2.7"
      ],
      "env": {
        "OUTLOOK_CLIENT_ID": "<outlook-client-id>",
        "OUTLOOK_TOKEN_CACHE": "<outlook-token-cache>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OUTLOOK_CLIENT_ID	yes	—	Application (client) ID from the Azure app registration. See docs/AZURE.en.md for how to obtain one.
OUTLOOK_TOKEN_CACHE	—	yes	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.

Freshness

Maintained — last maintenance signal 48d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-23 · 48d ago · GitHub
Latest release
2026-08-19 · 52d ago · GitHub · v0.2.7
Package published
no data · npm/PyPI
Registry entry updated
2026-08-19 · 52d ago · official registry · v0.2.7

FAQ

›How do I install the Outlook Mailbox Tidier MCP server in Claude Code?

Run: claude mcp add outlook-ma2no4413 -e OUTLOOK_CLIENT_ID='<outlook-client-id>' -e OUTLOOK_TOKEN_CACHE='<outlook-token-cache>' -- docker run -i --rm -e OUTLOOK_CLIENT_ID -e OUTLOOK_TOKEN_CACHE ghcr.io/ma2no4413/outlook-mcp:0.2.7. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Outlook Mailbox Tidier require an API key?

Yes. It expects OUTLOOK_CLIENT_ID, OUTLOOK_TOKEN_CACHE, of which 1 is a secret.

›Can I use Outlook Mailbox Tidier as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Outlook Mailbox Tidier in the official MCP registry?

Yes, as io.github.ma2no4413/outlook-mcp.