Tidy a large Outlook / Hotmail mailbox. Folder subtree moves, bulk ops with dry run, never sends.
Connect Runs on your machine
claude mcp add outlook-mcp -e OUTLOOK_CLIENT_ID=<OUTLOOK_CLIENT_ID> -e OUTLOOK_TOKEN_CACHE=<OUTLOOK_TOKEN_CACHE> -e OUTLOOK_TENANT=<OUTLOOK_TENANT> -e OUTLOOK_READONLY=<OUTLOOK_READONLY> -- docker run -i --rm ghcr.io/ma2no4413/outlook-mcp:0.2.7{
"mcpServers": {
"outlook-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ma2no4413/outlook-mcp:0.2.7"
],
"env": {
"OUTLOOK_CLIENT_ID": "<OUTLOOK_CLIENT_ID>",
"OUTLOOK_TOKEN_CACHE": "<OUTLOOK_TOKEN_CACHE>",
"OUTLOOK_TENANT": "<OUTLOOK_TENANT>",
"OUTLOOK_READONLY": "<OUTLOOK_READONLY>"
}
}
}
}{
"mcpServers": {
"outlook-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ma2no4413/outlook-mcp:0.2.7"
],
"env": {
"OUTLOOK_CLIENT_ID": "<OUTLOOK_CLIENT_ID>",
"OUTLOOK_TOKEN_CACHE": "<OUTLOOK_TOKEN_CACHE>",
"OUTLOOK_TENANT": "<OUTLOOK_TENANT>",
"OUTLOOK_READONLY": "<OUTLOOK_READONLY>"
}
}
}
}{
"servers": {
"outlook-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ma2no4413/outlook-mcp:0.2.7"
],
"env": {
"OUTLOOK_CLIENT_ID": "<OUTLOOK_CLIENT_ID>",
"OUTLOOK_TOKEN_CACHE": "<OUTLOOK_TOKEN_CACHE>",
"OUTLOOK_TENANT": "<OUTLOOK_TENANT>",
"OUTLOOK_READONLY": "<OUTLOOK_READONLY>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
OUTLOOK_CLIENT_IDRequired | Application (client) ID from the Azure app registration. See docs/AZURE.en.md for how to obtain one. |
OUTLOOK_TOKEN_CACHEOptional, 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_TENANTOptional | common for personal and work/school accounts, consumers for personal Microsoft accounts only. Defaults to common. |
OUTLOOK_READONLYOptional | Set to true to disable every write tool at once, leaving only search and read. |
Details
| Package | ghcr.io/ma2no4413/outlook-mcp:0.2.7 (OCI, stdio) |
| First published | 19 Aug 2026 |
| Last updated | 19 Aug 2026 |
| Registry name | io.github.ma2no4413/outlook-mcp |
More communication servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.