Office 365 Email MCP

An MCP server that lets an AI agent send email through Microsoft 365 / Office 365 using the OAuth2 client-credentials (app-only) flow and the Microsoft Graph API.

No interactive login at runtime — register an app once, grant it Mail.Send, and the server sends mail headlessly. Ideal for automation, notifications, and agent workflows.

Features

• office365_send_email — send plain-text or HTML email, with CC/BCC and local file attachments.

• office365_test_connection — verify your OAuth2 config by acquiring a token (sends nothing).

• App-only auth (no user sign-in), tokens cached and refreshed automatically by MSAL.

• Clear, actionable error messages for the common auth/permission/mailbox mistakes.

Related MCP server: mcp-outlook-mail

How it works

agent → MCP tool → MSAL (client credentials) → Entra ID → access token
                 → POST https://graph.microsoft.com/v1.0/users/{sender}/sendMail

Prerequisites

• Python 3.10+

• A Microsoft 365 tenant where you can register an app (or an admin who can).

• A licensed mailbox to send from.

1. Register the app in Microsoft Entra ID

1. Go to Entra admin center → Identity → Applications → App registrations → New registration.

2. Name it (e.g. office365-email-mcp), leave redirect URI blank, Register.

3. Copy the Application (client) ID and Directory (tenant) ID from the Overview page.

4. Certificates & secrets → New client secret → copy the secret Value (shown once).

5. API permissions → Add a permission → Microsoft Graph → Application permissions → Mail.Send → Add.

6. Click Grant admin consent for your tenant. (Requires an admin; the green check must appear.)

Scope it down (recommended). Mail.Send (Application) lets the app send as any mailbox in the tenant. Restrict it to specific mailboxes with an Application Access Policy in Exchange Online:

New-ApplicationAccessPolicy -AppId <CLIENT_ID> `
  -PolicyScopeGroupId mcp-senders@yourdomain.com `
  -AccessRight RestrictAccess `
  -Description "Restrict office365-email-mcp to the mcp-senders group"

2. Install

# from a clone of this repo
pip install .

# or run without installing, using uv
uvx --from . office365-email-mcp

3. Configure

Set these environment variables (see .env.example):

4. Add to your MCP client

Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "office365-email": {
      "command": "office365-email-mcp",
      "env": {
        "O365_TENANT_ID": "00000000-0000-0000-0000-000000000000",
        "O365_CLIENT_ID": "00000000-0000-0000-0000-000000000000",
        "O365_CLIENT_SECRET": "your-secret-value",
        "O365_SENDER": "noreply@yourdomain.com"
      }
    }
  }
}

If you didn't pip install, use "command": "uvx" with "args": ["--from", "/path/to/repo", "office365-email-mcp"].

Tools

office365_send_email

office365_test_connection

No parameters. Acquires a token and reports success/failure — run this first when troubleshooting.

Troubleshooting

Security notes

• The client secret is a credential — keep it out of source control (.env is gitignored). Rotate it periodically.

• Prefer an Application Access Policy so the app can only send as intended mailboxes.

• Attachments over ~3 MB exceed Graph's single-request sendMail limit; share a link instead.

License

MIT