Outlook Personal MCP

An open-source MCP server that provides full control over a personal Outlook.com mailbox and calendar through the Microsoft Graph API. It supports device-code authentication for personal accounts and integrates with Claude Code, Codex, and Claude Desktop.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Community listingLocal stdioSource reviewed; not executedPublished by salahawad

You need:OUTLOOK_MCP_CLIENT_ID= < your-app-client-id >

Vendor documentation

Checks and signals

Each line is separate evidence, not a trust score.

Popularity 2 GitHub stars

What you can do with it

Manage personal Outlook.com email
Access and modify personal calendar events
Integrate with Claude Code for AI-assisted email tasks

Source and maintenance

Community listingRegistry 0.1.1MIT

mcp-registry: io.github.salahawad/outlook-personal-mcp@0.1.1 Source repository

Last repository push: Jun 28, 2026, 9:19 AM UTC
Maintenance checked: Nov 2, 2026, 5:49 PM UTC

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

mcp-outlook-personal 0.1.1

pypiuvx

mcp-outlook-personal package definition

{
  "version": "0.1.1",
  "transport": "stdio",
  "identifier": "mcp-outlook-personal",
  "runtimeHint": "uvx",
  "registryType": "pypi",
  "environmentVariables": [
    {
      "name": "OUTLOOK_MCP_CLIENT_ID",
      "isRequired": true,
      "description": "Azure App Registration client ID (Application ID). Required. Create a free app at https://portal.azure.com — see README for the three-minute setup."
    },
    {
      "name": "OUTLOOK_MCP_AUTHORITY",
      "description": "Azure AD authority URL. Defaults to https://login.microsoftonline.com/consumers which covers personal Microsoft accounts (Outlook.com, Hotmail, Live). Change only if you target a different tenant."
    },
    {
      "name": "OUTLOOK_MCP_FILE_ROOT",
      "description": "Only files under this directory can be read by add_attachment or written by download_attachment. Defaults to ~/.local/share/outlook-personal-mcp/files."
    },
    {
      "name": "OUTLOOK_MCP_MAX_FILE_BYTES",
      "description": "Maximum bytes allowed for local attachment reads and attachment downloads. Defaults to 3145728."
    },
    {
      "name": "OUTLOOK_MCP_ALLOW_PERMANENT_DELETE",
      "description": "Set to 'true' to enable the permanent_delete tool which irrecoverably erases messages (bypasses Deleted Items). Disabled by default for safety."
    },
    {
      "name": "OUTLOOK_MCP_DEBUG",
      "description": "Set to 'true' to enable debug-level logging for Graph API requests and responses."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 2, 2026, 5:49 PM UTC · repository · passed · metadata changed · updated
Nov 2, 2026, 5:49 PM UTC · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.

Cursor configuration

{
  "mcpServers": {
    "outlook-personal-mcp": {
      "command": "uvx",
      "args": [
        "mcp-outlook-personal==0.1.1"
      ],
      "env": {
        "OUTLOOK_MCP_CLIENT_ID": "<YOUR_OUTLOOK_MCP_CLIENT_ID>",
        "OUTLOOK_MCP_AUTHORITY": "<YOUR_OUTLOOK_MCP_AUTHORITY>",
        "OUTLOOK_MCP_FILE_ROOT": "<YOUR_OUTLOOK_MCP_FILE_ROOT>",
        "OUTLOOK_MCP_MAX_FILE_BYTES": "<YOUR_OUTLOOK_MCP_MAX_FILE_BYTES>",
        "OUTLOOK_MCP_ALLOW_PERMANENT_DELETE": "<YOUR_OUTLOOK_MCP_ALLOW_PERMANENT_DELETE>",
        "OUTLOOK_MCP_DEBUG": "<YOUR_OUTLOOK_MCP_DEBUG>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.

Cline configuration

{
  "mcpServers": {
    "outlook-personal-mcp": {
      "command": "uvx",
      "args": [
        "mcp-outlook-personal==0.1.1"
      ],
      "env": {
        "OUTLOOK_MCP_CLIENT_ID": "<YOUR_OUTLOOK_MCP_CLIENT_ID>",
        "OUTLOOK_MCP_AUTHORITY": "<YOUR_OUTLOOK_MCP_AUTHORITY>",
        "OUTLOOK_MCP_FILE_ROOT": "<YOUR_OUTLOOK_MCP_FILE_ROOT>",
        "OUTLOOK_MCP_MAX_FILE_BYTES": "<YOUR_OUTLOOK_MCP_MAX_FILE_BYTES>",
        "OUTLOOK_MCP_ALLOW_PERMANENT_DELETE": "<YOUR_OUTLOOK_MCP_ALLOW_PERMANENT_DELETE>",
        "OUTLOOK_MCP_DEBUG": "<YOUR_OUTLOOK_MCP_DEBUG>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.

VS Code configuration

{
  "servers": {
    "outlook-personal-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-outlook-personal==0.1.1"
      ],
      "env": {
        "OUTLOOK_MCP_CLIENT_ID": "<YOUR_OUTLOOK_MCP_CLIENT_ID>",
        "OUTLOOK_MCP_AUTHORITY": "<YOUR_OUTLOOK_MCP_AUTHORITY>",
        "OUTLOOK_MCP_FILE_ROOT": "<YOUR_OUTLOOK_MCP_FILE_ROOT>",
        "OUTLOOK_MCP_MAX_FILE_BYTES": "<YOUR_OUTLOOK_MCP_MAX_FILE_BYTES>",
        "OUTLOOK_MCP_ALLOW_PERMANENT_DELETE": "<YOUR_OUTLOOK_MCP_ALLOW_PERMANENT_DELETE>",
        "OUTLOOK_MCP_DEBUG": "<YOUR_OUTLOOK_MCP_DEBUG>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.

Claude Desktop configuration

{
  "mcpServers": {
    "outlook-personal-mcp": {
      "command": "uvx",
      "args": [
        "mcp-outlook-personal==0.1.1"
      ],
      "env": {
        "OUTLOOK_MCP_CLIENT_ID": "<YOUR_OUTLOOK_MCP_CLIENT_ID>",
        "OUTLOOK_MCP_AUTHORITY": "<YOUR_OUTLOOK_MCP_AUTHORITY>",
        "OUTLOOK_MCP_FILE_ROOT": "<YOUR_OUTLOOK_MCP_FILE_ROOT>",
        "OUTLOOK_MCP_MAX_FILE_BYTES": "<YOUR_OUTLOOK_MCP_MAX_FILE_BYTES>",
        "OUTLOOK_MCP_ALLOW_PERMANENT_DELETE": "<YOUR_OUTLOOK_MCP_ALLOW_PERMANENT_DELETE>",
        "OUTLOOK_MCP_DEBUG": "<YOUR_OUTLOOK_MCP_DEBUG>"
      }
    }
  }
}

Let your agent find its tools

Find servers like Outlook Personal MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 5,960