XenoXilus/outlook-mcp

A Model Context Protocol (MCP) server that enables AI assistants to interact with Microsoft Outlook email and calendar through the Microsoft Graph API.
## Features
Email Operations: Read, search, send, reply to emails and download attachments
SharePoint Integration: Access SharePoint files via sharing links or direct file IDs. Download files shared to you via emails.
Calendar Management: View and manage calendar events and appointments
Office Document Processing: Parse PDF, Word, PowerPoint, and Excel files with extracted text content
Receipt & Invoice Collection: Discover emailed receipts by sender/subject/date, save them as verified and consistently named PDFs (attachment, billing link, or rendered fallback), and stage a review draft — built for scheduled, non-interactive runs
Large File Support: Automatic handling of files that exceed MCP response size limits
## Quick Start
Choose your installation method:
| Method | Best For |
| DXT Extension | Claude Desktop users |
| CLI Configuration | Claude Code, mcp CLI, other MCP clients |
> Prerequisites: Before installing, you'll need to set up an Azure application to get your Client ID and Tenant ID.
## Installation
### Installing as DXT Extension
For Claude Desktop users, DXT extensions provide the simplest installation experience.
Option 1: Download Pre-built Extension
1. Download outlook-mcp.dxt from the Releases page
2. In Claude Desktop, go to Settings → Extensions
3. Click Install from file and select the .dxt file
4. Enter your Azure Client ID, Tenant ID, and optional download directory when prompted
Option 2: Build from Source
1. Clone and install dependencies:
bash
git clone https://github.com/XenoXilus/outlook-mcp.git
cd outlook-mcp
npm install
2. Install the DXT CLI: npm install -g @anthropic-ai/dxt
3. Pack the extension:
bash
dxt pack . outlook-mcp.dxt
4. Install the generated .dxt file in Claude Desktop as above
### Using with CLI Tools
For CLI-based MCP clients (Claude Code, mcp CLI, etc.), configure the server directly.
1. Clone and Install:
bash
git clone https://github.com/XenoXilus/outlook-mcp.git
cd outlook-mcp
npm install
2. Configure your MCP client:
Add the following to your MCP servers configuration (location varies by client):
json
"outlook-mcp": {
"command": "node",
"args": ["/absolute/path/to/outlook-mcp/server/index.js"],
"env": {
"AZURECLIENTID": "your-azure-client-id",
"AZURETENANTID": "your-azure-tenant-id",
"MCPOUTLOOKWORKDIR": "/optional/download/directory"
Common config file locations:
Claude Code: ~/.claude.json or project-level .mcp.json
mcp CLI: ~/.config/mcp/servers.json
3. Alternative: Use environment variables
Instead of specifying env in the config, you can export the variables in your shell:
bash
export AZURECLIENTID="your-azure-client-id"
export AZURETENANTID="your-azure-tenant-id"
export MCPOUTLOOKWORKDIR="/optional/download/directory"
## Azure Setup Guide
To use this MCP server, you need to register an application in Microsoft Azure.
### For Business/Work Accounts (Recommended)
1. Go to the Azure Portal and search for "App registrations".
2. Click New registration.
Name: Outlook MCP (or similar)
Supported account types: Accounts in this organizational directory only (Single tenant)