Outlook Mailbox Tidier
Tidy a large Outlook / Hotmail mailbox. Folder subtree moves, bulk ops with dry run…
- 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.7Add 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.RequiredOUTLOOK_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

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity