io.github.mcp-z/mcp-outlook

Official

Outlook

Outlook integration with OAuth, message search, batch operations, and calendar management

Manage Outlook emails, calendar events, and perform batch message operations.

Install

Configuration

Environment variables

MS_CLIENT_IDrequired

Microsoft OAuth client ID (required for OAuth authentication modes)

MS_TENANT_IDrequired

Microsoft tenant ID (required for OAuth authentication)

MS_CLIENT_SECRETsecret

Microsoft OAuth client secret (optional for public clients)

AUTH_MODEdefault loopback-oauth

Authentication mode

HEADLESSdefault false

Disable browser auto-open, return auth URL instead (true/false)

REDIRECT_URI

OAuth redirect URI (optional, default: ephemeral loopback)

RESOURCE_STORE_URIdefault file://~/.mcp-z/mcp-outlook/files

Resource store URI for CSV export files (file://)

PORT

HTTP server port (overrides --port)

BASE_URL

Base URL for HTTP transport (used for OAuth/DCR endpoints and file links)

LOG_LEVELdefault info

Logging level

DCR_MODEdefault self-hosted

Dynamic Client Registration mode

DCR_VERIFY_URL

External verification endpoint URL (required for external DCR mode)

DCR_STORE_URIdefault file://~/.mcp-z/mcp-outlook/dcr.json

DCR client storage URI (for self-hosted DCR mode)

Arguments

-y

--auth

--tenant-id

--headless

--redirect-uri

--resource-store-uri

--base-url

--log-level

--portdefault 9003

--dcr-mode

--dcr-verify-url

--dcr-store-uri

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-outlook": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-z/mcp-outlook@1.0.13",
        "--auth",
        "--tenant-id",
        "--headless",
        "--redirect-uri",
        "--resource-store-uri",
        "--base-url",
        "--log-level"
      ],
      "env": {
        "MS_CLIENT_ID": "<YOUR_MS_CLIENT_ID>",
        "MS_TENANT_ID": "<YOUR_MS_TENANT_ID>",
        "MS_CLIENT_SECRET": "<YOUR_MS_CLIENT_SECRET>",
        "AUTH_MODE": "loopback-oauth",
        "HEADLESS": "false",
        "REDIRECT_URI": "<YOUR_REDIRECT_URI>",
        "RESOURCE_STORE_URI": "file://~/.mcp-z/mcp-outlook/files",
        "PORT": "<YOUR_PORT>",
        "BASE_URL": "<YOUR_BASE_URL>",
        "LOG_LEVEL": "info"
      }
    }
  }
}