Outlook Local MCP
Local Microsoft Outlook calendar and mail via Microsoft Graph, with multi-account support and OS keychain token storage.
Install
The installation steps are in the documentation below. Documentation
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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 and triage email, and compose drafts without leaving your AI assistant.
Install
Go binary (recommended):
go install github.com/desek/outlook-local-mcp/cmd/outlook-local-mcp@latestDocker / 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:latestSee 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.
Claude Code or Cowork plugin: install the plugin from the Claude directory with /plugin. See the quickstart.
Tool invocation shape
All operations use four aggregate domain tools dispatched by an operation verb, plus two opt-in ones registered only when their variable is set, contacts under OUTLOOK_MCP_CONTACTS_ENABLED and teams under OUTLOOK_MCP_TEAMS_ENABLED:
{tool: "calendar", args: {operation: "list_events", date: "today"}}
{tool: "mail", args: {operation: "list_folders"}}
{tool: "account", args: {operation: "list"}}
{tool: "system", args: {operation: "status"}}
{tool: "contacts", args: {operation: "search", query: "alex"}} // OUTLOOK_MCP_CONTACTS_ENABLED
{tool: "teams", args: {operation: "search", query: "release checklist"}} // OUTLOOK_MCP_TEAMS_ENABLEDCall 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.
Privacy Policy
The server runs locally and sends your data only to Microsoft services with your own credentials. Read the full privacy policy for what it accesses, keeps, and contacts.
Acknowledgements
Support and testing by GigWhere ❤️
License
MIT License. See LICENSE for details.
Frequently asked questions
What is Outlook Local MCP?
Local Microsoft Outlook calendar and mail via Microsoft Graph, with multi-account support and OS keychain token storage.
How do I install Outlook Local MCP?
Follow the installation steps in its documentation, shown on this page and in its repository.
Is Outlook Local MCP open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Outlook Local MCP?
It is published by desek. AI.tn lists it but does not maintain or endorse it.
From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.