Skip to content
MCP server

Outlook Mailbox Tidier

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.7
Listing updated
4 days ago

About Outlook Mailbox Tidier

Outlook Mailbox Tidier is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add outlook-mcp --env OUTLOOK_CLIENT_ID='<OUTLOOK_CLIENT_ID>' --env 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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "outlook-mcp": {
      "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

{
  "mcpServers": {
    "outlook-mcp": {
      "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

{
  "servers": {
    "outlook-mcp": {
      "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 ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "outlook-mcp": {
      "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 your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "outlook-mcp": {
      "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>"
      }
    }
  }
}

Configuration

  • OUTLOOK_CLIENT_IDApplication (client) ID from the Azure app registration. See docs/AZURE.en.md for how to obtain one.Required
  • OUTLOOK_TOKEN_CACHEPath 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_TENANTcommon for personal and work/school accounts, consumers for personal Microsoft accounts only. Defaults to common.
  • OUTLOOK_READONLYSet to true to disable every write tool at once, leaving only search and read.

Pricing

Open source

Outlook Mailbox Tidier FAQ

Is Outlook Mailbox Tidier free?

Yes. Outlook Mailbox Tidier is open source, so you can use and self-host it for free.

How do I add Outlook Mailbox Tidier to Claude Code?

Run this command in your terminal: claude mcp add outlook-mcp --env OUTLOOK_CLIENT_ID='<OUTLOOK_CLIENT_ID>' --env 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

What are the best alternatives to Outlook Mailbox Tidier?

The closest alternatives to Outlook Mailbox Tidier are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to Outlook Mailbox Tidier

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity