Outlook Personal MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add outlook-personal-mcp -e 'OUTLOOK_MCP_CLIENT_ID=<OUTLOOK_MCP_CLIENT_ID>' -- uvx mcp-outlook-personal

{
  "mcpServers": {
    "outlook-personal-mcp": {
      "command": "uvx",
      "args": [
        "mcp-outlook-personal"
      ],
      "env": {
        "OUTLOOK_MCP_CLIENT_ID": "<OUTLOOK_MCP_CLIENT_ID>"
      }
    }
  }
}

[mcp_servers.outlook-personal-mcp]
command = "uvx"
args = ["mcp-outlook-personal"]
env = { OUTLOOK_MCP_CLIENT_ID = "<OUTLOOK_MCP_CLIENT_ID>" }

{
  "mcpServers": {
    "outlook-personal-mcp": {
      "command": "uvx",
      "args": [
        "mcp-outlook-personal"
      ],
      "env": {
        "OUTLOOK_MCP_CLIENT_ID": "<OUTLOOK_MCP_CLIENT_ID>"
      }
    }
  }
}

{
  "servers": {
    "outlook-personal-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-outlook-personal"
      ],
      "env": {
        "OUTLOOK_MCP_CLIENT_ID": "<OUTLOOK_MCP_CLIENT_ID>"
      }
    }
  }
}

Put your own value in place of <OUTLOOK_MCP_CLIENT_ID> (Azure App Registration client ID (Application ID). Required. Create a free app at https://portal.azure.com — see README for the three-minute setup). The author’s registry entry marks it as required.

Optional settings from the registry entry, left out of the block above: OUTLOOK_MCP_AUTHORITY (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), OUTLOOK_MCP_FILE_ROOT (Only files under this directory can be read by add_attachment or written by download_attachment. Defaults to ~/.local/share/outlook-personal-mcp/files), OUTLOOK_MCP_MAX_FILE_BYTES (Maximum bytes allowed for local attachment reads and attachment downloads. Defaults to 3145728), OUTLOOK_MCP_ALLOW_PERMANENT_DELETE (Set to 'true' to enable the permanent_delete tool which irrecoverably erases messages (bypasses Deleted Items). Disabled by default for safety), OUTLOOK_MCP_DEBUG (Set to 'true' to enable debug-level logging for Graph API requests and responses).