Outlook Mail MCP Server

by pepebitsio.github.Pepebits/outlook-mcpv1.2.0

Read, search, send and clean up Outlook.com / Hotmail mail through Microsoft Graph.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install Outlook Mail MCP server

claude mcp add outlook-pepebits -- npx -y @pepebits/outlook-mcp

{
  "mcpServers": {
    "outlook-pepebits": {
      "command": "npx",
      "args": [
        "-y",
        "@pepebits/outlook-mcp"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "outlook-pepebits": {
      "command": "npx",
      "args": [
        "-y",
        "@pepebits/outlook-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "outlook-pepebits": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pepebits/outlook-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "outlook-pepebits": {
      "command": "npx",
      "args": [
        "-y",
        "@pepebits/outlook-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OUTLOOK_CLIENT_ID	—	—	Your own Azure app (client) ID. Leave unset to use the shared app for personal accounts.
OUTLOOK_TENANT	—	—	consumers (default), organizations, common or a tenant ID.
OUTLOOK_READ_ONLY	—	—	Set to true to expose only read-only tools.
OUTLOOK_TOKEN_STORE	—	—	auto (default), keychain or file: where the token cache is stored.