Skip to content
MCP server

MCP Outlook

Outlook mail and OneDrive files via Microsoft Graph — read, search, send and organize.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.4.1
Listing updated
4 days ago

About MCP Outlook

MCP Outlook is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add mcp-outlook --env OUTLOOK_CLIENT_SECRET='<OUTLOOK_CLIENT_SECRET>' --env OUTLOOK_TOKEN='<OUTLOOK_TOKEN>' -- npx -y @dockndevai/mcp-outlook

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-outlook": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-outlook"
      ],
      "env": {
        "OUTLOOK_CLIENT_SECRET": "<OUTLOOK_CLIENT_SECRET>",
        "OUTLOOK_TOKEN": "<OUTLOOK_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-outlook": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-outlook"
      ],
      "env": {
        "OUTLOOK_CLIENT_SECRET": "<OUTLOOK_CLIENT_SECRET>",
        "OUTLOOK_TOKEN": "<OUTLOOK_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-outlook": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-outlook"
      ],
      "env": {
        "OUTLOOK_CLIENT_SECRET": "<OUTLOOK_CLIENT_SECRET>",
        "OUTLOOK_TOKEN": "<OUTLOOK_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp-outlook": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-outlook"
      ],
      "env": {
        "OUTLOOK_CLIENT_SECRET": "<OUTLOOK_CLIENT_SECRET>",
        "OUTLOOK_TOKEN": "<OUTLOOK_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-outlook": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-outlook"
      ],
      "env": {
        "OUTLOOK_CLIENT_SECRET": "<OUTLOOK_CLIENT_SECRET>",
        "OUTLOOK_TOKEN": "<OUTLOOK_TOKEN>"
      }
    }
  }
}

Configuration

  • OUTLOOK_CLIENT_IDEntra (Azure AD) app (client) id. For browser sign-in, register a public client with redirect URI http://localhost.
  • OUTLOOK_TENANT_IDDirectory tenant: a tenant id, or common | organizations | consumers (default common).
  • OUTLOOK_CLIENT_SECRETApp secret for app-only (client-credentials) auth. Omit to use interactive browser sign-in.
  • OUTLOOK_TOKENA pre-obtained Microsoft Graph bearer token (alternative to browser or app-only auth).
  • OUTLOOK_USERTarget mailbox (user id or UPN) for app-only auth. Omit to use the signed-in user's mailbox (/me).
  • OUTLOOK_MODEAccess mode: read-only | read-write | admin. Starts read-only; writes need read-write.
  • OUTLOOK_ALLOW_SENDSet true to permit sending mail (send/reply/forward). Off by default.

Pricing

Open source

MCP Outlook FAQ

Is MCP Outlook free?

Yes. MCP Outlook is open source, so you can use and self-host it for free.

How do I add MCP Outlook to Claude Code?

Run this command in your terminal: claude mcp add mcp-outlook --env OUTLOOK_CLIENT_SECRET='<OUTLOOK_CLIENT_SECRET>' --env OUTLOOK_TOKEN='<OUTLOOK_TOKEN>' -- npx -y @dockndevai/mcp-outlook

What are the best alternatives to MCP Outlook?

The closest alternatives to MCP Outlook are ASTra, BoardAgent, Callout, CARTESIAN ECU and Invoices.

Alternatives to MCP Outlook

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  3. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  4. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  5. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  6. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication