feat(coding/agents): add Outlook MCP server via Microsoft Graph #10

Merged
m3tam3re merged 1 commits from feat/outlook-graph-mcp into master 2026-11-12 09:13:08 +01:00
Collaborator

Summary

Adds an Outlook entry to the shared MCP catalogue (programs.mcp), so OpenCode and Claude Code get mail, calendar and contacts of the signed-in M365 account.

  • Packages marlonluo2018/microsoft_graph_mcp_server from a pinned commit (not on PyPI) in profiles/sets/coding/agents/microsoft-graph-mcp-server.nix.
  • Chosen over the originally requested outlook-mcp-server by the same author, which drives the Outlook desktop client via win32COM and only runs on Windows; this one talks to the Graph API and runs on our NixOS hosts.
  • Auth is the device-code flow against Microsoft's public client id, no Azure app registration. Tokens land in ~/.microsoft_graph_mcp_tokens.json.
  • Built against python3Packages.mcp_1: upstream uses the 1.x low-level Server API that mcp 2.x removed.
  • Import check limited to the config module; server.py builds an MSAL client at import time and hits the network in the sandbox.
  • USER_TIMEZONE defaults to Europe/Berlin via the wrapper, overridable from the environment.

Validation

  • nix build of the package succeeds.
  • Module evaluates; programs.mcp.servers.Outlook.command points at the store binary.
  • Smoke test over stdio: initialize and tools/list answer with 15 tools, nothing is written into the store path.

First use

Call the auth tool with start, confirm the device code in the browser, then auth with complete.

🤖 Generated with Claude Code

## Summary Adds an `Outlook` entry to the shared MCP catalogue (`programs.mcp`), so OpenCode and Claude Code get mail, calendar and contacts of the signed-in M365 account. - Packages [marlonluo2018/microsoft_graph_mcp_server](https://github.com/marlonluo2018/microsoft_graph_mcp_server) from a pinned commit (not on PyPI) in `profiles/sets/coding/agents/microsoft-graph-mcp-server.nix`. - Chosen over the originally requested `outlook-mcp-server` by the same author, which drives the Outlook desktop client via win32COM and only runs on Windows; this one talks to the Graph API and runs on our NixOS hosts. - Auth is the device-code flow against Microsoft's public client id, no Azure app registration. Tokens land in `~/.microsoft_graph_mcp_tokens.json`. - Built against `python3Packages.mcp_1`: upstream uses the 1.x low-level `Server` API that mcp 2.x removed. - Import check limited to the config module; `server.py` builds an MSAL client at import time and hits the network in the sandbox. - `USER_TIMEZONE` defaults to `Europe/Berlin` via the wrapper, overridable from the environment. ## Validation - `nix build` of the package succeeds. - Module evaluates; `programs.mcp.servers.Outlook.command` points at the store binary. - Smoke test over stdio: `initialize` and `tools/list` answer with 15 tools, nothing is written into the store path. ## First use Call the `auth` tool with `start`, confirm the device code in the browser, then `auth` with `complete`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
m3ta-chiron added 1 commit 2026-11-12 09:11:55 +01:00
- Package marlonluo2018/microsoft_graph_mcp_server as a Python app; it talks to the Graph API, so it runs on Linux
- Register it as the Outlook entry in the shared MCP catalogue (mcp.nix)
- Authenticate with the device-code flow (`auth` tool, start then complete); tokens are stored in ~/.microsoft_graph_mcp_tokens.json
- Default USER_TIMEZONE to Europe/Berlin
m3tam3re merged commit e3c8498fde into master 2026-11-12 09:13:08 +01:00
m3tam3re deleted branch feat/outlook-graph-mcp 2026-11-12 09:13:08 +01:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: m3tam3re/m3ta-home#10