Outlook MCP

An MCP server that connects GitHub Copilot and other AI agents to Microsoft Outlook via the Microsoft Graph API.

Features

Related MCP server: MCP Outlook Server

Requirements

• Python 3.12+

• A Microsoft 365 account with Outlook

• A Microsoft Graph API bearer token with Mail.Read, Mail.Send, and Mail.ReadWrite scopes

Quick Start

# 1. Clone the repository
git clone https://github.com/your-org/outlook-mcp.git
cd outlook-mcp

# 2. Create a virtual environment and install dependencies
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt

# 3. Run setup to configure VS Code
.\setup.ps1

Configuration

The server reads these environment variables:

Getting an OUTLOOK_TOKEN

For development / testing — use Graph Explorer:

1. Sign in with your Microsoft 365 account.

2. Click Access token in the top panel.

3. Copy the token.

For production — register an Entra ID application with delegated permissions (Mail.Read, Mail.Send, Mail.ReadWrite) and implement OAuth 2.0 to obtain tokens programmatically.

Running manually

export OUTLOOK_TOKEN=your_token_here
python server.py

Docker

docker build -t outlook-mcp .
docker run -e OUTLOOK_TOKEN=your_token_here outlook-mcp

VS Code MCP configuration

.vscode/mcp.json (generated by setup.ps1):

{
  "servers": {
    "outlook-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["server.py"],
      "env": {
        "OUTLOOK_TOKEN": "your_token_here"
      }
    }
  }
}

License

MIT