@lnwebworks/outlook-mcp-server

An MCP (Model Context Protocol) server that connects Claude (or any MCP-compatible client) to Outlook via the Microsoft Graph API, using client-credentials (app-only) auth.

Installation

npm install -g @lnwebworks/outlook-mcp-server

Or run directly with npx:

npx @lnwebworks/outlook-mcp-server

Configuration

Copy .env.example to .env and fill in your Azure AD app registration details:

cp .env.example .env

Required:

• AZURE_TENANT_ID
• AZURE_CLIENT_ID
• AZURE_CLIENT_SECRET
• OUTLOOK_USER_EMAIL — the mailbox this server acts on by default

Optional:

• OUTLOOK_EXCLUDED_FOLDER_IDS
• OUTLOOK_SKIP_EXCLUDED_FOLDERS
• OUTLOOK_SIGNOFF_NAME

Usage with an MCP client

Add this server to your MCP client's config, e.g.:

{
  "mcpServers": {
    "outlook": {
      "command": "npx",
      "args": ["-y", "@lnwebworks/outlook-mcp-server"],
      "env": {
        "AZURE_TENANT_ID": "...",
        "AZURE_CLIENT_ID": "...",
        "AZURE_CLIENT_SECRET": "...",
        "OUTLOOK_USER_EMAIL": "..."
      }
    }
  }
}

License

MIT