Outlook MCP Server

A Model Context Protocol (MCP) server for sending emails via Microsoft Outlook using the Microsoft Graph API.

Features

• Send emails with To, CC, and BCC recipients
• Attach files (up to 3MB each)
• Secure authentication using OAuth 2.0 client credentials flow
• Easy deployment - runs with Python or uvx

Installation

Using pip

pip install mareana-outlook-mcp-server

Using uvx

uvx mareana-outlook-mcp-server

From source

git clone https://github.com/mareana/outlook-mcp-server.git
cd outlook-mcp-server
pip install -e .

Configuration

Set the following environment variables:

Example

export MS_CLIENT_ID="your-client-id"
export MS_CLIENT_SECRET="your-client-secret"
export MS_TENANT_ID="your-tenant-id"
export MS_FROM_EMAIL="neptune.ai@mareana.com"

Usage

Running the Server

With Python:

mareana-outlook-mcp-server

With uvx:

uvx mareana-outlook-mcp-server

From source:

python -m outlook_mcp_server.server

MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "outlook": {
      "command": "uvx",
      "args": ["mareana-outlook-mcp-server"],
      "env": {
        "MS_CLIENT_ID": "your-client-id",
        "MS_CLIENT_SECRET": "your-client-secret",
        "MS_TENANT_ID": "your-tenant-id",
        "MS_FROM_EMAIL": "sender@yourdomain.com"
      }
    }
  }
}

Or using Python directly:

{
  "mcpServers": {
    "outlook": {
      "command": "python3",
      "args": ["-m", "outlook_mcp_server.server"],
      "env": {
        "MS_CLIENT_ID": "your-client-id",
        "MS_CLIENT_SECRET": "your-client-secret",
        "MS_TENANT_ID": "your-tenant-id",
        "MS_FROM_EMAIL": "sender@yourdomain.com"
      }
    }
  }
}

Available Tools

send_email

Send an email with optional CC, BCC, and attachments.

Parameters:

Example:

{
  "to": ["recipient@example.com"],
  "subject": "Hello from MCP",
  "body": "This is a test email sent via the Outlook MCP server.",
  "cc": ["cc@example.com"],
  "attachments": ["/path/to/document.pdf"]
}

License

MIT License - see LICENSE for details.

Author

Shashanka G - shashanka.g@mareana.com