Outlook MCP Server

by dockndevaiio.github.dockndevai/mcp-outlookv0.3.0

Outlook mail via Microsoft Graph: read, search, draft, send and organize email. Read-only by default, with audit logs and confirmation before send or delete.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install Outlook MCP server

claude mcp add outlook -e OUTLOOK_CLIENT_SECRET='<outlook-client-secret>' -e OUTLOOK_TOKEN='<outlook-token>' -- npx -y @dockndevai/mcp-outlook

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

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

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

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

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

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

{
  "mcpServers": {
    "outlook": {
      "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.

Configuration

Variable	Required	Secret	Description
OUTLOOK_CLIENT_ID	—	—	Entra (Azure AD) app (client) id. For browser sign-in, register a public client with redirect URI http://localhost.
OUTLOOK_TENANT_ID	—	—	Directory tenant: a tenant id, or common \| organizations \| consumers (default common).
OUTLOOK_CLIENT_SECRET	—	yes	App secret for app-only (client-credentials) auth. Omit to use interactive browser sign-in.
OUTLOOK_TOKEN	—	yes	A pre-obtained Microsoft Graph bearer token (alternative to browser or app-only auth).
OUTLOOK_USER	—	—	Target mailbox (user id or UPN) for app-only auth. Omit to use the signed-in user's mailbox (/me).
OUTLOOK_MODE	—	—	Access mode: read-only \| read-write \| admin. Starts read-only; writes need read-write.
OUTLOOK_ALLOW_SEND	—	—	Set true to permit sending mail (send/reply/forward). Off by default.

Freshness

Active — last maintenance signal 10d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-29 · 10d ago · GitHub
Latest release
2026-09-29 · 10d ago · GitHub · v0.3.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-29 · 10d ago · official registry · v0.3.0

FAQ

›How do I install the Outlook MCP server in Claude Code?

Run: claude mcp add outlook -e OUTLOOK_CLIENT_SECRET='<outlook-client-secret>' -e OUTLOOK_TOKEN='<outlook-token>' -- npx -y @dockndevai/mcp-outlook. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Outlook require an API key?

Yes. It expects OUTLOOK_CLIENT_SECRET, OUTLOOK_TOKEN, of which 2 are secrets.

›Can I use Outlook as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Outlook in the official MCP registry?

Yes, as io.github.dockndevai/mcp-outlook.