Minerva MCP — Microsoft 365 & Azure MCP Server

Name: Minerva MCP — Microsoft 365 & Azure MCP Server
Author: io.github.HoussemMak

io.github.HoussemMak/minerva-mcp

Repository Registry

What is the Minerva MCP — Microsoft 365 & Azure MCP server?

Microsoft 365 & Azure admin: Graph, ARM, and the PowerShell cmdlets Graph does not expose.

How to install Minerva MCP — Microsoft 365 & Azure

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

AZURE_TENANT_ID
Entra tenant id. Only needed for unattended app-only sign-in; omit it to sign in interactively with a device code.
AZURE_CLIENT_ID
Application (client) id. Defaults to the public Microsoft Graph PowerShell client, so it is optional for trying the server out.
AZURE_CLIENT_SECRET
secret
Client secret for app-only authentication. Leave unset to sign in interactively instead.
MINERVA_SHAREPOINT_URL
SharePoint root URL, e.g. https://contoso.sharepoint.com. Required only by the SharePoint/PnP tool when PowerShell runs locally.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "minerva-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "minerva-mcp",
        "--stdio",
        "--read-only"
      ],
      "env": {
        "AZURE_TENANT_ID": "<YOUR_AZURE_TENANT_ID>",
        "AZURE_CLIENT_ID": "<YOUR_AZURE_CLIENT_ID>",
        "AZURE_CLIENT_SECRET": "<YOUR_AZURE_CLIENT_SECRET>",
        "MINERVA_SHAREPOINT_URL": "<YOUR_MINERVA_SHAREPOINT_URL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "minerva-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "minerva-mcp",
        "--stdio",
        "--read-only"
      ],
      "env": {
        "AZURE_TENANT_ID": "<YOUR_AZURE_TENANT_ID>",
        "AZURE_CLIENT_ID": "<YOUR_AZURE_CLIENT_ID>",
        "AZURE_CLIENT_SECRET": "<YOUR_AZURE_CLIENT_SECRET>",
        "MINERVA_SHAREPOINT_URL": "<YOUR_MINERVA_SHAREPOINT_URL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "minerva-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "minerva-mcp",
        "--stdio",
        "--read-only"
      ],
      "env": {
        "AZURE_TENANT_ID": "<YOUR_AZURE_TENANT_ID>",
        "AZURE_CLIENT_ID": "<YOUR_AZURE_CLIENT_ID>",
        "AZURE_CLIENT_SECRET": "<YOUR_AZURE_CLIENT_SECRET>",
        "MINERVA_SHAREPOINT_URL": "<YOUR_MINERVA_SHAREPOINT_URL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "minerva-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "minerva-mcp",
        "--stdio",
        "--read-only"
      ],
      "env": {
        "AZURE_TENANT_ID": "<YOUR_AZURE_TENANT_ID>",
        "AZURE_CLIENT_ID": "<YOUR_AZURE_CLIENT_ID>",
        "AZURE_CLIENT_SECRET": "<YOUR_AZURE_CLIENT_SECRET>",
        "MINERVA_SHAREPOINT_URL": "<YOUR_MINERVA_SHAREPOINT_URL>"
      }
    }
  }
}

Claude Code

claude mcp add minerva-mcp --env AZURE_TENANT_ID=<YOUR_AZURE_TENANT_ID> --env AZURE_CLIENT_ID=<YOUR_AZURE_CLIENT_ID> --env AZURE_CLIENT_SECRET=<YOUR_AZURE_CLIENT_SECRET> --env MINERVA_SHAREPOINT_URL=<YOUR_MINERVA_SHAREPOINT_URL> -- npx -y minerva-mcp --stdio --read-only