Outlook Local MCP Server

A single-binary MCP server that connects Claude Desktop and Claude Code to Microsoft Outlook via the Microsoft Graph API. Manage your calendar, read email, and compose drafts without leaving your AI assistant.

<p align="center"> <img src="docs/assets/demo.gif" alt="outlook-local-mcp demo"> </p>

Install

Go binary (recommended):

go install github.com/desek/outlook-local-mcp/cmd/outlook-local-mcp@latest

Docker / OCI:

docker run -i --rm \
  -v outlook-mcp-auth:/data/auth \
  -e OUTLOOK_MCP_TENANT_ID=<tenant> \
  -e OUTLOOK_MCP_CLIENT_ID=<client> \
  ghcr.io/desek/outlook-local-mcp:latest

See Container deployment for the full client config snippet, and Container runtime for the keychain trade-off and image variants.

Claude Desktop extension (no terminal required):

Download the .mcpb file from the latest release and open it in Claude Desktop via Settings > Extensions > Install from file.

Tool invocation shape

All operations use four aggregate domain tools dispatched by an operation verb:

{tool: "calendar", args: {operation: "list_events", date: "today"}}
{tool: "mail",     args: {operation: "list_folders"}}
{tool: "account",  args: {operation: "list"}}
{tool: "system",   args: {operation: "status"}}

Call any domain with operation: "help" to list its verbs and parameters.

Documentation

Guide	Contents
docs/readme.md	Project overview and feature list
docs/quickstart.md	Prerequisites, installation, and first tool call
docs/concepts.md	Output tiers, multi-account model, mail gating, OAuth scopes, observability, and more
docs/troubleshooting.md	Auth errors, Keychain issues, Graph throttling, and account lifecycle

For LLM clients: see llms.txt for a machine-readable index.

Acknowledgements

Support and testing by GigWhere ❤️

License

MIT License. See LICENSE for details.